Google API'leri için Üstel Gecikmeli Yeniden Deneme (Exponential Backoff)

Genel Bakış

Bu n8n iş akışı, Google API'leri ile iletişim kurarken ortaya çıkabilecek geçici hataları (örneğin, ağ kesintileri, hız sınırlamaları, sunucu hataları) yönetmek için Üstel Gecikmeli Yeniden Deneme (Exponential Backoff) stratejisini kullanır. Başarısız olan API isteklerini, her denemede artan bir bekleme süresiyle otomatik olarak yeniden dener. Bu sayede, API'nin aşırı yüklenmesi engellenir ve iş akışınızın daha sağlam ve güvenilir çalışması sağlanır.

Gereksinimler

• n8n Hesabı: Bu iş akışını çalıştırmak için aktif bir n8n hesabına ihtiyacınız vardır.
• Google Hesabı: Google Sheets veya diğer Google API'lerini kullanmak için bir Google hesabına ve ilgili API'ler için etkinleştirilmiş erişime sahip olmanız gerekir.
• Google API Kimlik Bilgileri: Google Sheets düğümünü kullanmak için n8n'de yapılandırılmış bir Google API kimlik bilgisine (OAuth 2.0 veya Servis Hesabı) ihtiyacınız olacaktır.

Kurulum Adımları

1. İş Akışını İçe Aktarma: Bu iş akışı JSON dosyasını n8n arayüzünüze içe aktarın.
2. Google Kimlik Bilgilerini Yapılandırma:
   • n8n arayüzünde sol menüden 'Kimlik Bilgileri' (Credentials) bölümüne gidin.
   • 'Yeni Kimlik Bilgisi Ekle' (Add New Credential) düğmesine tıklayın.
   • 'Google API' seçeneğini arayın ve seçin.
   • Kimlik bilgisi türü olarak 'OAuth2' veya 'Service Account' seçeneğini belirleyin. Çoğu kullanım durumu için 'OAuth2' önerilir.
   • 'OAuth2' seçeneğini seçtiyseniz, 'Google ile Bağlan' (Connect with Google) düğmesine tıklayarak Google hesabınızla oturum açın ve n8n'e gerekli izinleri verin. Gerekli izinler genellikle Google Sheets için 'Google Sheets API' kapsamını içerir.
   • Kimlik bilgilerine açıklayıcı bir isim verin (örn: 'Google Sheets API Kimlik Bilgileri').
   • Kaydedin.
3. Google Sheets Düğümünü Yapılandırma: İş akışındaki 'Google Sheets' düğümünü seçin.
   • 'Kimlik Bilgileri' (Credentials) alanında, az önce oluşturduğunuz Google API kimlik bilgisini seçin.
   • Yapmak istediğiniz işlemi (örn: 'Append Row', 'Read Sheet') ve hedef e-tablo kimliğini (Spreadsheet ID) ve sayfa adını (Sheet Name) ayarlayın.
4. Kod Düğümünü İnceleme: İş akışındaki 'Code' düğümü, Üstel Gecikmeli Yeniden Deneme mantığını içerir. Bu düğüm, başarısız bir denemeden sonra ne kadar bekleneceğini ve kaç kez yeniden deneneceğini belirler. Varsayılan değerleri ihtiyaçlarınıza göre ayarlayabilirsiniz (örn: maxRetries, initialDelaySeconds).
5. İş Akışını Test Etme: İş akışını manuel olarak çalıştırarak veya bir test tetikleyicisi kullanarak test edin. Google Sheets düğümünün beklediğiniz gibi çalıştığından ve hata durumunda yeniden deneme mantığının devreye girdiğinden emin olun.
6. İş Akışını Aktifleştirme: İş akışının sağ üst köşesindeki 'Aktif' (Active) düğmesini açarak iş akışını etkinleştirin.

Kullanım Senaryoları

• Senaryo 1: Yoğun Google Sheets Veri Girişi: Bir web formundan gelen verileri Google Sheets'e sürekli olarak yazarken, Google API'sinin hız sınırlamalarına takılma riskini azaltmak için bu iş akışını kullanabilirsiniz. Başarısız olan her yazma işlemi, artan bir gecikmeyle otomatik olarak yeniden denenecektir.
• Senaryo 2: Google Drive Dosya İşlemleri: Büyük miktarda dosyayı Google Drive'a yüklerken veya indirirken, geçici ağ sorunları veya API kotaları nedeniyle oluşabilecek hataları yönetmek için bu mekanizmayı kullanabilirsiniz. İş akışı, başarısız olan her işlemi otomatik olarak yeniden dener.

İpuçları ve Öneriler

• Gecikme Sürelerini Ayarlama: 'Code' düğümündeki initialDelaySeconds ve maxRetries değerlerini, kullandığınız Google API'sinin hız sınırlamalarına ve uygulamanızın toleransına göre ayarlayın. Çok kısa gecikmeler API'yi tekrar zorlayabilir, çok uzun gecikmeler ise iş akışınızı yavaşlatabilir.
• Hata Yönetimi: Yeniden denemelerden sonra hala başarısız olan istekler için ek hata yönetimi (örn: Slack'e bildirim gönderme, bir hata günlüğüne yazma) eklemeyi düşünebilirsiniz.
• Günlükleri İzleme: İş akışı yürütme günlüklerini düzenli olarak kontrol ederek yeniden deneme mekanizmasının beklendiği gibi çalıştığından ve olası kalıcı hataları tespit ettiğinizden emin olun.