Google Mail Get Message Content Batch aksiyonu, Gmail üzerinde birden fazla e-postanın içeriklerini tek seferde almak için kullanılır. Kullanıcı, messageIds parametresiyle birden fazla e-posta kimliğini gönderdiğinde, aksiyon ilgili tüm mesajların gövde içeriklerini, başlık bilgilerini ve eklerini (varsa) döner. Özellikle raporlama, toplu içerik kontrolü veya e-postaların başka sistemlere aktarılması gereken senaryolarda tercih edilir.
Teknik Özellikler
İşlev: Birden fazla Gmail e-postasının içeriklerini toplu şekilde getirir.
Parametreler:
settings (Object – zorunlu): Gmail entegrasyonu için gerekli bağlantı ayarları.
messageIds (String – Many, zorunlu): Gmail’deki e-postaların benzersiz kimlik değerleri (virgül ile ayrılmış veya liste şeklinde).
Sonuç: Çoklu (Many) döner → seçilen tüm e-postaların detaylarını içerir.
Değer Bağlama:
messageIds sabit (Fixed Value) girilebilir.
Dinamik olarak Google Mail Search Messages çıktısından seçilip bağlanabilir.
Web & Mobil Destek: Hem web hem de mobil uygulamalarda kullanılabilir.
Google Mail Get Message Content Batch Uygulama Adımları
1. Aksiyon Ekleme
Kuika platformunda projenizi açın.
UI Design modülünde toplu işlem yapılacak ekranı açın.
+ ADD ACTION → Google → Google Mail Get Message Content Batch aksiyonunu ekleyin.
2. Parametreleri Yapılandırma
settings: Gmail bağlantısı için seçilir.
messageIds:
Sabit değer → [ "17c4f5d2a6b...", "17c4f5d2a6c..." ]
Dinamik değer → Kullanıcının listeden seçtiği e-postaların id bilgileri aktarılır.
Kullanım Senaryosu: "Toplu Mail İçeriği Çekme"
Bir raporlama uygulamasında kullanıcı, Gmail üzerinden belirli filtrelere uyan e-postaları arar ve hepsinin içeriklerini topluca görüntülemek ister.
Adımlar:
Google Mail Search Messages ile filtrelenmiş e-postalar bulunur.
Kullanıcı tüm mesajları seçer.
Google Mail Get Message Content Batch çalışır ve tüm seçilen messageIds parametresiyle çağrılır.
Dönen içerikler Table elementinde gösterilir.
Google Mail Get Message Content Batch İleri Seviye Özelleştirmeler
Toplu Analiz: Dönen içerikler üzerinde metin analizi (ör. duygu analizi, keyword extraction) yapılabilir.
Otomatik Yönlendirme: Gelen e-postaların içerikleri başka sistemlere (ör. Trello, Google Drive) otomatik aktarılabilir.
Performans Kontrolü: Çok fazla mesaj çağırıldığında API limiti kontrol edilmelidir.
Teknik Riskler ve Kontroller
messageIds boş girilirse sonuç dönmez.
Yanlış veya silinmiş e-posta kimlikleri hataya yol açabilir.
Çok büyük batch işlemlerinde (örn. yüzlerce e-posta) performans sorunları yaşanabilir.