Google Mail Search Messages aksiyonu, Gmail üzerinde belirli kriterlere göre e-posta araması yapmak için kullanılır. Kullanıcı, query parametresini kullanarak Gmail’in arama sözdizimi (örn. from:, subject:, before:, after:) ile filtrelenmiş e-postaları getirebilir. Bu aksiyon, gelen kutusu yönetimi, raporlama, müşteri iletişim takibi ve otomatik iş akışları için kullanılabilir.

Teknik Özellikler

• İşlev: Gmail hesabında arama yaparak e-posta listesi döner.
• Parametreler:
  
  • settings (Object – zorunlu): Gmail entegrasyonu için bağlantı ayarları.
  • query (String – zorunlu): Gmail arama kriteri.
    
    • Örnekler:
      
      • "from:abc@gmail.com" → Belirli gönderen.
      • "subject:Rapor" → Konusu “Rapor” olan mailler.
      • "after:2025/09/01 before:2025/09/17" → Belirli tarih aralığı.
  • pageSize (Int32 – opsiyonel): Kaç e-posta döneceğini belirler.
• Sonuç: Çoklu (Many) → eşleşen e-postaların ID ve özet bilgileri döner.
• Değer Bağlama:
  
  • Parametreler sabit (Fixed) girilebilir.
  • Dinamik değerler Symbol Picker ile bağlanabilir (örn. kullanıcı arama kutusu → query).
• Web & Mobil Destek: Hem web hem de mobil uygulamalarda çalışır.

Google Mail Search Messages Uygulama Adımları

1. Aksiyon Ekleme

• Kuika projenizde arama yapılacak ekranı açın.
• UI Design → + ADD ACTION → Google → Google Mail Search Messages ekleyin.

2. Parametreleri Yapılandırma

• settings: Gmail entegrasyonu için ayar seçilir.
• query:
  
  • Sabit değer → "from:info@firma.com".
  • Dinamik değer → Kullanıcı arama kutusuna yazdığı ifadeyi buraya bağlayın.
• pageSize: Sonuç sayısını belirler (örn. 20).

Kullanım Senaryosu: "Gelen Kutusunda Rapor Mailleri Arama"

Bir iş uygulamasında kullanıcı, Gmail üzerinden “Rapor” başlıklı tüm mailleri aramak istiyor.

Adımlar:

1. Kullanıcı arama kutusuna “Rapor” yazar.
2. query = "subject:Rapor" olarak aksiyona gönderilir.
3. Google Mail Search Messages çalışır ve uygun mailler döner.
4. Sonuçlar ekranda Table elementiyle gösterilir.

Google Mail Search Messages İleri Seviye Özelleştirmeler

• Dinamik Arama: Kullanıcının seçtiği tarih aralığı veya gönderen → query parametresine otomatik eklenebilir.
• Sonuçların Kullanımı: Dönen messageId değerleri, Google Mail Get Message Content veya Batch aksiyonuna aktarılabilir.
• Koşullu Filtreleme: E-postaların etiketlerine göre ek iş akışları tetiklenebilir.

Teknik Riskler ve Kontroller

• query boş bırakılırsa Gmail gelen kutusundaki tüm mailler dönebilir (performans düşer).
• Çok yüksek pageSize (örn. 500+) performans sorunlarına neden olabilir.
• Yanlış yazılmış Gmail arama operatörleri sonuç getirmeyebilir.