Google Drive Node

Google Drive node'u, SkyStudio workflow'larında Google Drive ve Google Sheets ile entegrasyon sağlar. Dosya okuma, arama, klasör yönetimi ve elektronik tablo işlemleri yapabilirsiniz.

---

🎬 Videoyu izlemek için tıklayın →

Bağlantı Kurulumu ve Yönetimi

Google Drive node'unu kullanabilmek için önce bir Google hesabı bağlantısı oluşturmanız gerekir. Google Drive, Jira ve Confluence'dan farklı olarak OAuth 2.0 kimlik doğrulama yöntemini kullanır.

Yeni Bağlantı Ekleme

1. SkyStudio'nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
2. Google Drive seçeneğine tıklayın.
3. Bağlantı yöntemi olarak OAuth 2.0 seçili olduğundan emin olun (varsayılan ve önerilen).
4. Bağlantı adı alanına bu bağlantı için bir isim girin (zorunlu).
5. Google ile yetkilendir butonuna tıklayın.

Alan	Açıklama	Örnek
Bağlantı adı	Bu bağlantıya vermek istediğiniz isim	Şirket Google Drive
Bağlantı yöntemi	Kimlik doğrulama türü	OAuth 2.0 (önerilen)

Bağlantı Yöntemleri

OAuth 2.0 (Önerilen) Tarayıcı üzerinden Google hesabınızla yetkilendirme yapılır. Backend OAuth URL'i yapılandırıldığında tek tıklamayla açılır. En güvenli ve kolay yöntemdir.

API Anahtarı / Gelişmiş Kimlik bilgilerini JSON formatında manuel olarak girebilirsiniz. Kendi Google Cloud OAuth istemcinizi kullanmak istiyorsanız bu yöntemi tercih edin.

Yetkilendirme Adımları

1. Google ile yetkilendir butonuna tıklayın.
2. Açılan Google oturum açma penceresinde hesabınızı seçin.
3. SkyStudio'nun istediği izinleri onaylayın.
4. Yetkilendirme başarılı olduğunda bağlantı otomatik kaydedilir.

Not: Yetkilendirme sırasında Google, Drive ve Sheets erişimi için izin isteyecektir. Workflow'larınızın düzgün çalışması için tüm istenen izinleri onaylayın.

Bağlantıyı Node'a Atama

Google Drive node'unu canvas'a sürükledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden daha önce oluşturduğunuz bağlantıyı seçin.

---

Operasyonlar

Google Drive node'u 13 operasyon sunmaktadır:

Operasyon	Kategori	Açıklama
Dosyaları Listele	Öne Çıkan	Belirli bir klasördeki dosya ve klasörleri listeler
Dosya Ara	Öne Çıkan	Arama sorgusuyla Drive'da dosya arar
Google Drive AI Asistan	Öne Çıkan	Doğal dil ile Drive dosyalarını sorgular
Spreadsheet Satırları Getir	Öne Çıkan	Google Sheets'ten satır verilerini getirir
Dosya İçeriğini Oku	Öne Çıkan	Bir dosyanın içeriğini okur (AI analizi seçeneğiyle)
Dosyaya Sor	Öne Çıkan	Bir dosya hakkında doğal dilde soru sorar
Dosya Bilgisi Getir	Standart	Dosya metadata bilgilerini getirir
Klasör Oluştur	Standart	Drive'da yeni klasör oluşturur
Spreadsheet Bilgisi	Standart	Google Sheets hakkında meta veri getirir
Satır Ekle	Standart	Google Sheets'e yeni satır ekler
Hücre Güncelle	Standart	Google Sheets'teki hücre değerlerini günceller
Hücreleri Temizle	Standart	Google Sheets'teki hücreleri temizler
Spreadsheet Oluştur	Standart	Yeni bir Google Sheets dosyası oluşturur

---

Dosyaları Listele

Belirli bir klasördeki tüm dosya ve alt klasörleri listeler. Klasör ID verilmezse Drive'ın kök dizini listelenir.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google Drive bağlantısı
Folder ID	Hayır	Listelenecek klasörün Drive ID'si (boş = kök dizin)
Page Size	Hayır	Sayfa başına getirilecek dosya sayısı

Folder ID Nasıl Bulunur?

Google Drive'da klasörü açın. URL'deki son segment Folder ID'dir. Örnek: https://drive.google.com/drive/folders/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs → ID: 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs

---

Dosya Ara

Google Drive arama söz dizimiyle dosya arar. Ad, içerik, MIME türü gibi kriterlere göre filtreleme yapılabilir.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google Drive bağlantısı
Search Query	Evet	Drive arama sorgusu
Page Size	Hayır	Sayfa başına getirilecek sonuç sayısı

Arama Sorgusu Örnekleri

Amaç	Sorgu
İsme göre ara	name contains 'rapor'
Belirli türü bul	mimeType = 'application/pdf'
Klasör içinde ara	'FOLDER_ID' in parents
Yıldızlı dosyalar	starred = true
Son değiştirilen	modifiedTime > '2024-01-01'

---

Google Drive AI Asistan

Doğal dil kullanarak Drive dosyalarınızı sorgular. Dosya içeriklerini anlamlandırmak ve bilgi çıkarmak için kullanılır.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google Drive bağlantısı
Query	Evet	Doğal dilde soru veya görev
System Prompt	Hayır	AI davranışını özelleştiren talimat

Kullanım Örneği

Query: "Geçen ay paylaşılan toplantı notlarını bul ve özetle"

System Prompt: "Yalnızca 'Toplantı Notları' klasöründeki dosyalara bak. Yanıtı Türkçe ver."

---

Spreadsheet Satırları Getir

Google Sheets'ten belirli bir aralıktaki satırları JSON formatında getirir.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google Drive bağlantısı
Spreadsheet ID	Evet	Google Sheets dosyasının Drive ID'si
Range	Hayır	Okunacak hücre aralığı (örn. Sheet1!A1:D100)
First Row is Header	Hayır	İlk satırın başlık satırı olup olmadığı

Spreadsheet ID Nasıl Bulunur?

Google Sheets URL'sindeki /d/ ile /edit arasındaki kısım Spreadsheet ID'dir. Örnek: https://docs.google.com/spreadsheets/d/1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs/edit → ID: 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs

Range Formatı

• Tüm sayfa: Sheet1 veya Sayfa1
• Belirli aralık: Sheet1!A1:D50
• Tüm A sütunu: Sheet1!A:A
• İlk 10 satır: Sheet1!1:10

---

Dosya İçeriğini Oku

Google Drive'daki bir dosyanın içeriğini okur. Okuma yöntemine göre ham metin, AI analizi veya yapılandırılmış veri döndürebilir.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google Drive bağlantısı
File ID	Evet	Okunacak dosyanın Drive ID'si
Read Method	Hayır	Okuma yöntemi (raw, analyze vb.)
After Reading	Hayır	Okuma sonrası yapılacak işlem
AI Prompt (if analyzing)	Hayır	AI analizi için kullanılacak talimat
Response Language	Hayır	Yanıtın dili

Desteklenen Dosya Türleri

Google Docs, Google Sheets, Google Slides, PDF, TXT, DOCX ve diğer metin tabanlı dosyalar okunabilir.

---

Dosyaya Sor

Bir Drive dosyası hakkında doğal dilde soru sormanızı sağlar. Dosya içeriği otomatik olarak yüklenip AI ile işlenir.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google Drive bağlantısı
File ID	Evet	Sorgu yapılacak dosyanın Drive ID'si
Question	Evet	Dosya hakkında sorulacak doğal dil sorusu
Response Language	Hayır	Yanıtın dili

Kullanım Örneği

File ID: 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs

Question: "Bu rapordaki ana bulgular nelerdir? Madde madde listele."

Response Language: Turkish

---

Dosya Bilgisi Getir

Bir dosyanın adı, boyutu, oluşturulma tarihi, MIME türü gibi meta veri bilgilerini getirir. Dosya içeriğini okumaz.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google Drive bağlantısı
File ID	Evet	Meta verisi alınacak dosyanın Drive ID'si

Örnek Çıktı

{
  "id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs",
  "name": "Q4 Satış Raporu.pdf",
  "mimeType": "application/pdf",
  "size": "245760",
  "createdTime": "2024-10-01T09:00:00.000Z",
  "modifiedTime": "2024-11-15T14:30:00.000Z",
  "webViewLink": "https://drive.google.com/file/d/..."
}

---

Klasör Oluştur

Google Drive'da yeni bir klasör oluşturur. İsteğe bağlı olarak mevcut bir klasörün içine oluşturulabilir.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google Drive bağlantısı
Folder Name	Evet	Oluşturulacak klasörün adı
Parent Folder ID	Hayır	Üst klasörün Drive ID'si (boş = kök dizin)

---

Spreadsheet Bilgisi

Bir Google Sheets dosyasının sayfa adları, satır/sütun sayısı gibi yapısal meta veri bilgilerini getirir.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google Drive bağlantısı
Spreadsheet ID	Evet	Bilgisi alınacak Sheets dosyasının ID'si

---

Satır Ekle

Mevcut bir Google Sheets sayfasına yeni satır(lar) ekler.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google Drive bağlantısı
Spreadsheet ID	Evet	Hedef Sheets dosyasının ID'si
Sheet Name	Evet	Satır eklenecek sayfa adı (örn. Sheet1)
Rows (JSON)	Evet	Eklenecek satır verileri (JSON dizi formatında)

Rows Formatı

[
  { "Ad": "Ayşe", "Soyad": "Kaya", "Departman": "Pazarlama" },
  { "Ad": "Mehmet", "Soyad": "Demir", "Departman": "Mühendislik" }
]

---

Hücre Güncelle

Google Sheets'teki belirli bir aralıktaki hücre değerlerini günceller.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google Drive bağlantısı
Spreadsheet ID	Evet	Hedef Sheets dosyasının ID'si
Range	Evet	Güncellenecek hücre aralığı (örn. Sheet1!B2:C3)
Values (2D JSON Array)	Evet	Yazılacak değerler (2 boyutlu dizi formatında)

Values Formatı

[
  ["Yeni Değer 1", "Yeni Değer 2"],
  ["Yeni Değer 3", "Yeni Değer 4"]
]

---

Hücreleri Temizle

Google Sheets'teki belirli bir aralıktaki hücre içeriklerini siler (format korunur).

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google Drive bağlantısı
Spreadsheet ID	Evet	Hedef Sheets dosyasının ID'si
Range	Evet	Temizlenecek hücre aralığı (örn. Sheet1!A2:Z1000)

Not: Bu işlem yalnızca hücre içeriklerini siler, hücre biçimlendirmesini (renk, font vb.) korur.

---

Spreadsheet Oluştur

Yeni bir Google Sheets dosyası oluşturur. İstenilen sayfa adlarını başlangıçta tanımlayabilirsiniz.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google Drive bağlantısı
Spreadsheet Title	Evet	Oluşturulacak Sheets dosyasının adı
Sheet Names (CSV)	Hayır	Virgülle ayrılmış sayfa adları (örn. Ocak,Şubat,Mart)

Örnek Çıktı

{
  "spreadsheetId": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs",
  "spreadsheetUrl": "https://docs.google.com/spreadsheets/d/...",
  "title": "2025 Satış Takip Tablosu"
}

---

Hızlı Başlangıç Örnekleri

Örnek 1: Belge Soru-Cevap Asistanı

Kullanıcının Drive'daki herhangi bir belge hakkında soru sorabildiği bir workflow:

Metin Girişi (Dosya ID) → Dosyaya Sor → Metin Çıktısı

Dosyaya Sor ayarları:

• File ID: {{input.dosya_id}}
• Question: {{input.soru}}
• Response Language: Turkish

---

Örnek 2: Otomatik Rapor Toplama

Belirli bir klasördeki tüm PDF raporları bulup içeriklerini özetleyen workflow:

Dosya Ara → Döngü → Dosya İçeriğini Oku → LLM (özetle) → Satır Ekle

Dosya Ara ayarları:

• Search Query: 'KLASOR_ID' in parents and mimeType = 'application/pdf'

Dosya İçeriğini Oku ayarları:

• Read Method: analyze
• AI Prompt: "Bu raporun ana bulgularını 3 madde halinde özetle"

---

Örnek 3: Form Verilerini Sheets'e Kaydet

Webhook ile gelen form verilerini otomatik Google Sheets'e yazan workflow:

Webhook → Satır Ekle (Google Sheets)

Satır Ekle ayarları:

• Spreadsheet ID: 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs
• Sheet Name: Başvurular
• Rows (JSON): [{"Ad": "{{webhook.ad}}", "Email": "{{webhook.email}}", "Tarih": "{{now}}"}]

---

Örnek 4: Klasör Yapısı Oluşturma

Yeni bir proje için standart klasör yapısını otomatik oluşturan workflow:

Metin Girişi (Proje Adı) → Klasör Oluştur (Ana) → Klasör Oluştur (Alt1) → Klasör Oluştur (Alt2)

İlk Klasör Oluştur ayarları:

• Folder Name: {{input.proje_adi}}
• Parent Folder ID: PROJELER_KLASORU_ID

---

Sık Karşılaşılan Hatalar

Hata	Olası Neden	Çözüm
401 Unauthorized	OAuth token süresi dolmuş	Bağlantıyı yenilemek için Google ile tekrar yetkilendirin
403 Forbidden	Dosyaya erişim izni yok	Google Drive'da paylaşım ayarlarını kontrol edin
404 File not found	Geçersiz File ID veya Spreadsheet ID	ID'yi Drive URL'sinden yeniden kopyalayın
Invalid range	Yanlış Range formatı	Sheet1!A1:D10 formatını kullandığınızdan emin olun
Quota exceeded	Google API günlük limiti aşıldı	İstekler arasına gecikme ekleyin veya ertesi gün deneyin
Token has been expired	OAuth yetkilendirmesi süresi dolmuş	Uygulama Bağlantıları'ndan bağlantıyı yenileyin

---

Notlar

• File ID ile Spreadsheet ID aynı kavramdır — her Google Sheets dosyası aynı zamanda bir Drive dosyasıdır.
• Google Drive API, günlük istek limitlerine sahiptir. Büyük veri işlemlerinde Page Size ve istek aralıklarını göz önünde bulundurun.
• Dosyaya Sor ve Dosya İçeriğini Oku (AI analizi) operasyonları büyük dosyalarda daha uzun süre alabilir.
• Google Workspace (Docs, Sheets, Slides) dışı ikili dosyalar (resim, video vb.) içerik okuma için desteklenmeyebilir.