API Kullanıcı Verilerini Google E-Tablolara Kaydet ve CSV Yedeklemesi Oluştur

Genel Bakış

Bu iş akışı, herhangi bir REST API'den kullanıcı verilerini güvenli bir şekilde çekmek, doğrulamak, işlemek ve hem Google E-Tablolar'a kaydetmek hem de bir CSV dosyası olarak yedeklemek için tasarlanmıştır. Bu sayede verileriniz hem merkezi bir konumda erişilebilir olur hem de çevrimdışı veya diğer sistemlerle entegrasyon için hazır bulunur.

Gereksinimler

• Google Hesabı: Google E-Tablolar'a erişim ve veri yazma yetkisi için gereklidir.
• Hedef API Erişimi: Kullanıcı verilerini çekeceğiniz API'ye erişim izni ve gerekli kimlik bilgileri (API Anahtarı, Token vb.) gereklidir.
• n8n Kurulumu: n8n'in çalışan bir örneğine sahip olmanız gerekmektedir (bulut veya kendi barındırdığınız).

Kurulum Adımları

1. n8n İş Akışını İçe Aktarma: Bu iş akışı JSON'unu n8n arayüzünüze içe aktarın.
2. Manuel Tetikleyici (Manual Trigger): İş akışını manuel olarak başlatmak için bu düğmeyi kullanın. Genellikle test ve ilk kurulum için kullanılır. Dilerseniz bir zamanlayıcı (Cron) veya webhook gibi farklı bir tetikleyici ile değiştirebilirsiniz.
3. HTTP İsteği (HTTP Request):
   • URL alanına kullanıcı verilerini çekeceğiniz API'nin endpoint URL'sini girin.
   • Method olarak genellikle GET seçilir.
   • API'niz kimlik doğrulama gerektiriyorsa, Authentication bölümünden uygun kimlik bilgisi türünü (örn: Header Auth, Query Auth, OAuth2) seçin ve gerekli bilgileri (API Anahtarı, Token vb.) girin. Bu kimlik bilgilerini n8n'in Credentials bölümünde tanımlamanız gerekebilir.
4. Eğer (If):
   • Bu düğme, API yanıtının başarılı olup olmadığını kontrol eder. Varsayılan olarak HTTP durum kodu 200 (OK) kontrol edilir. API'nizin başarılı yanıt koduna göre bu koşulu ayarlayabilirsiniz.
   • Eğer API yanıtı başarısız olursa, Stop and Error düğmesine yönlendirilir ve iş akışı durdurulur.
5. Fonksiyon (Function):
   • Bu düğme, API'den gelen ham veriyi Google E-Tablolar'a uygun bir formata dönüştürmek için kullanılır. Genellikle JSON yanıtından belirli alanları seçmek, yeniden adlandırmak veya dönüştürmek için JavaScript kodu yazılır.
   • Örnek: return items.map(item => ({ name: item.json.user.name, email: item.json.user.email, registrationDate: item.json.user.createdAt }));
6. Google E-Tablolar (Google Sheets):
   • Credential olarak bir Google Sheets kimlik bilgisi ekleyin veya seçin. Bu, n8n'in Google hesabınıza erişmesini sağlar.
   • Operation olarak Append Row (Satır Ekle) veya Update or Insert (Güncelle veya Ekle) seçeneğini belirleyin.
   • Spreadsheet ID alanına verileri kaydedeceğiniz Google E-Tablosu'nun ID'sini girin (URL'den alınabilir).
   • Sheet Name alanına hedef sayfanın adını girin (örn: Kullanıcılar).
   • Input Data olarak Function düğmesinden gelen verileri kullanın.
7. E-Tablo Dosyası (Spreadsheet File):
   • Input Data olarak yine Function düğmesinden gelen verileri kullanın.
   • File Format olarak CSV seçeneğini belirleyin.
   • File Name için dinamik bir isim verebilirsiniz (örn: Kullanici_Verileri_{{ $now().toFormat('yyyy-MM-dd') }}.csv).
   • Bu düğme, oluşturulan CSV dosyasını n8n'in geçici depolama alanına kaydeder. Bu dosyayı daha sonra bir bulut depolama hizmetine (Google Drive, S3 vb.) veya e-posta ile göndermek için başka bir düğüm ekleyebilirsiniz.

Kullanım Senaryoları

• Günlük Kullanıcı Senkronizasyonu: Her gün belirli bir saatte API'den yeni kayıt olan kullanıcıları çekip Google E-Tablolar'a ekleyerek pazarlama veya destek ekiplerinin güncel verilere sahip olmasını sağlamak.
• API Veri Yedeklemesi: Kritik API verilerini düzenli aralıklarla CSV formatında yedekleyerek veri kaybı riskini azaltmak ve çevrimdışı analizler için hazır bulundurmak.

İpuçları ve Öneriler

• Hata Yönetimi: If düğmesinden sonra Stop and Error yerine, hataları Slack'e bildiren veya bir log dosyasına yazan düğümler ekleyerek daha sağlam bir hata yönetimi oluşturabilirsiniz.
• Veri Dönüşümü: Function düğmesindeki JavaScript kodunu, API yanıtınızın yapısına ve Google E-Tablolar'daki sütun başlıklarınıza göre dikkatlice özelleştirin.
• Zamanlama: İş akışını düzenli aralıklarla otomatik olarak çalıştırmak için Manual Trigger yerine bir Cron düğümü kullanın.
• CSV Dosya Depolama: Spreadsheet File düğmesi yalnızca dosyayı oluşturur. Bu dosyayı kalıcı olarak depolamak için Google Drive, Amazon S3 veya SFTP gibi bir düğüm eklemeyi düşünün.
• Veri Doğrulama: Function düğmesinde veya ek bir If düğmesinde, Google E-Tablolar'a yazmadan önce verilerin belirli kriterlere (örn: e-posta formatı) uygunluğunu kontrol edebilirsiniz.