Google Sheets

Bu rehberde: İş akışınızdaki verileri (adaylar, yayınlanan gönderiler, rapor özetleri) bir Google tablosuna satır olarak eklersiniz. Tablo kimliğini bulmayı ve başlık satırını hazırlamayı öğrenirsiniz.

⏱ 15 dakika

Kimlik kartı#

Ne işe yarar?#

Kullanım örnekleri:

• Nitelikli adayları satış ekibinin paylaşılan tablosuna düşürmek.
• Yayınlanan her gönderiyi tarih, platform ve bağlantıyla bir "yayın günlüğü" sayfasına yazmak.
• Rapor metriklerini haftalık izleme tablosuna eklemek.

Yazma ekleme biçimindedir. Güncelleme gerektiren senaryolarda HubSpot veya Notion kullanın.

Ön koşullar#

• Hedef tabloda düzenleme yetkisi olan bir Google hesabı.
• Platform yöneticisinin GOOGLE_CLIENT_ID ve GOOGLE_CLIENT_SECRET tanımlamış olması (GA4, Search Console ve YouTube ile paylaşılır).
• Aynı Google Cloud projesinde Google Sheets API etkin.

Adım adım kurulum#

A) Google Cloud Console (platform yöneticisi)#

1. APIs & Services → Library → ① Google Sheets API → Enable.

2. Google Auth Platform → Data Access → ① https://www.googleapis.com/auth/spreadsheets.
3. ③ Audience: Workspace içindeyseniz Internal; aksi hâlde External ve Testing'de test kullanıcıları (izin 7 gün). ② Production için doğrulama.

4. Clients → Web application: ① Client ID, ② Client secret (GA4 ile aynı istemci olabilir).

5. ① Authorized redirect URIs: https://api.orqlabs.com/api/v1/integrations/oauth/google_sheets/callback (ve diğer Google sağlayıcılarınınkiler). ③ Save.

B) OrqLabs'ta bağlama#

1. Entegrasyonlar → Google Sheets → Bağla. Organizasyon geneli.
2. Google hesap seçme ekranında tabloya düzenleme yetkisi olan hesabı seçin.
3. "Google Sheets tablolarınızı görme, düzenleme…" iznini onaylayın. Testing'de "Google hasn't verified this app" uyarısında Advanced → Go to ….
4. Kart Bağlı olur. Kayda "Sheets – Satış hesabı" gibi bir ad verebilirsiniz.

C) Tabloyu hazırlama#

1. Tablonun adresi: https://docs.google.com/spreadsheets/d/<ID>/edit#gid=0. /d/ ile sonraki / arasındaki uzun dize tablo kimliğidir.
2. Hedef sayfanın ilk satırına sütun başlıklarını yazın. Başlıklar eşleme anahtarlarıyla birebir aynı olmalıdır.
3. CRM'e yaz kutusunda Bağlı hesap olarak Google Sheets'i seçin:

Örnek:

{
  "Ad": "{{ $json.name }}",
  "E-posta": "{{ $json.email }}",
  "Şirket": "{{ $json.company }}",
  "Puan": "{{ $json.score }}",
  "Durum": "{{ $json.status }}",
  "Eklenme": "{{ $now }}"
}

Eşlemede olup başlıkta bulunmayan anahtarlar yazılmaz; önce başlığı ekleyin.

İzinler ve kapsamlar#

OrqLabs Drive dosya listesi istemez; tabloyu kimliğiyle belirtirsiniz.

Limitler#

RATE_LIMIT hatalarında kutu Bekleme (ms) değerini 5.000+ yapın.

Bağlantıyı test etme#

② Bağlantıyı test et hesap e-postasını ve izni doğrular; belirli bir tabloyu okumaz. Tablo erişimini doğrulamak için iş akışını tek öğeyle test edin ve tablonun sonundaki yeni satırı kontrol edin.

Kimlik bilgilerini yenileme#

• Testing'de izin 7 günde düşer; uygulamayı yayınlayın.
• Erişim myaccount.google.com/permissions üzerinden kaldırılırsa Yeniden yetkilendir.
• Client secret değişirse tüm Google bağlantıları yeniden yetkilendirilir.
• Bağlayan kişi şirketten ayrılıyorsa önceden paylaşılan bir hesapla yeniden bağlayın.

Sık karşılaşılan hatalar#

Sık sorulan sorular#

Mevcut satırları günceller mi? Bu entegrasyon ekleme yapar. Güncelleme için HubSpot veya Notion kullanın.

Hangi sayfaya yazar? Target alanında sayfa adı yoksa ilk sayfaya.

Sonraki adım#

• CRM senkronizasyonu ve dışa aktarma
• HubSpot CRM, Notion
• Google Analytics 4