Bu rehberde: Google Drive'ınızı OrqLabs'a bağlarsınız. Google Drive kutusu haftalık raporları, ajan çıktılarını, görselleri ve klipleri seçtiğiniz klasöre kaydeder; isterseniz metni düzenlenebilir bir Google Dokümanı'na çevirir ve "bağlantıya sahip herkes görüntüleyebilir" paylaşımı açar.
⏱ 5 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | GOOGLE_DRIVE |
| Kategori | Veri / dosyalar |
| Kimlik doğrulama | Google izin ekranı (OAuth 2.0) – drive.file izni |
| Kapsam | Proje bazlı |
| Webhook | Hayır |
| Kutu | Google Drive (app.googleDrive) |
Önemli: OrqLabs yalnızca kendi dosyalarını görür
OrqLabs, Google'ın en dar Drive iznini (drive.file) kullanır: yalnızca OrqLabs'ın oluşturduğu dosya ve klasörleri görebilir ve değiştirebilir. Drive'ınızdaki diğer dosyalar, paylaşılan sürücüler veya başkalarının dosyaları OrqLabs'a görünmez.
- Klasörü adıyla verin (ör.
OrqLabs/Raporlar): yoksa ilk yüklemede oluşturulur. Drive'da elle oluşturduğunuz bir klasörün kimliğini (ID) verirseniz OrqLabs onu göremez veNOT_FOUNDdöner. - Drive'daki mevcut görsel ve videolarınızı medya kütüphanesine içe aktarma bu izinle mümkün değildir (Google Picker ile dosya seçimi gerekir); şimdilik dosyaları İçerik sayfasında gönderiye doğrudan yükleyin.
Ne işe yarar?
Upload file (Dosya yükle)
| Alan | Açıklama |
|---|---|
| File name | Dosya adı, ör. Haftalık rapor {{ $today }}.md |
| Text content | Kaydedilecek metin (rapor, açıklama, JSON). Boşsa aşağıdaki URL'den indirilir |
| Or file URL | Herkese açık https:// adresi (görsel, klip, PDF; en fazla 100 MB) |
| MIME type | Boş: indirmeden veya dosya uzantısından (.md → text/markdown, .csv, .html …) |
| Folder | Klasör adı veya yolu (OrqLabs/Raporlar); boş: Drive'ım kökü |
| Convert text to a Google Doc | Metin / HTML / Markdown içerik düzenlenebilir Google Dokümanı olur |
| Sharing | Özel (yalnızca ben) veya "Bağlantıya sahip herkes görüntüleyebilir" |
Çıktı: id, name, mimeType, size, webViewLink (Drive'da açma bağlantısı), webContentLink, folderId, shared. 5 MB'tan büyük dosyalar parçalı (resumable) yükleme ile gönderilir.
List files (Dosyaları listele) – OrqLabs'ın Drive'a kaydettiği dosyalar (en yeni önce), isteğe bağlı olarak tek bir klasörde ve ad filtresiyle; her dosya ayrı bir öğe.
Örnek akış
Haftalık GA4 raporu → Drive → Slack: Zamanlama (her pazartesi) → Rapor oluştur → Google Drive – Upload file (Text content: {{ $json.report }}, Folder: OrqLabs/Raporlar, Convert: açık, Sharing: bağlantıya sahip herkes) → Ekibe bildir (Slack: {{ $json.webViewLink }}).
Adım adım kurulum
A) Google Cloud Console (platform yöneticisi)
- APIs & Services → Library → Google Drive API → Enable.
- Google Auth Platform → Data Access → kapsam ekleyin:
https://www.googleapis.com/auth/drive.file,openid,.../auth/userinfo.email(hepsi hassas olmayan kapsamlar). - Clients → Web application istemcisi → Authorized redirect URIs →
https://api.orqlabs.com/api/v1/integrations/oauth/google_drive/callback→ Save. drive.filehassas olmayan bir kapsam olduğundan yalnızca marka doğrulaması (uygulama adı, logo, gizlilik politikası, alan adı) yeterlidir; kapsam incelemesi veya CASA gerekmez.
B) OrqLabs'ta bağlama
- Entegrasyonlar → Google Drive → Bağla → Proje.
- Google hesabınızı seçin → izni onaylayın ("yalnızca bu uygulamayla kullandığınız dosyalar").
- Bağlantıyı test et: Drive hesabınızın e-posta adresi görünür.
- İş akışına Google Drive kutusunu ekleyin.
İzinler ve kapsamlar
| Kapsam | Neden gerekli |
|---|---|
https://www.googleapis.com/auth/drive.file | OrqLabs'ın oluşturduğu dosya ve klasörleri yükleme, listeleme ve paylaşma |
openid, .../auth/userinfo.email | Bağlanan Google hesabının adresi |
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
NOT_FOUND – "folder … is not visible to OrqLabs" | Elle oluşturulmuş bir klasörün kimliği verildi | Klasörü adıyla verin; OrqLabs oluşturur |
INVALID – "give either Text content or a file URL" | İçerik ve URL ikisi de boş | Önceki adımın çıktısını Text content'e bağlayın |
INVALID – "media exceeds …" | Dosya 100 MB'tan büyük | Daha küçük bir dosya veya bağlantı kullanın |
CONFIG – "Google Drive API … etkin değil" | API Cloud projesinde kapalı | Platform yöneticisi Google Drive API'yi etkinleştirmeli |
RATE_LIMIT | Drive kotası | Otomatik yeniden denenir; çok sık çalışan akışları seyrekleştirin |
AUTH – invalid_grant | İzin iptal edildi | Yeniden yetkilendir |