Google Drive Search Files aksiyonu, Google Drive üzerinde dosya araması yapmak için kullanılır. Kullanıcı, belirli bir arama sorgusu (query) girerek Drive’daki dosyaları filtreleyebilir ve listeleyebilir. Bu aksiyon, özellikle büyük Drive alanlarında dosya bulma, rapor yönetimi veya belirli kriterlere göre belge getirme senaryolarında kullanılır.

Teknik Özellikler

• Arama İşlemi: Google Drive dosyaları üzerinde sorgu tabanlı arama yapar.
• Parametreler:
  
  • settings (Object – zorunlu): Google Drive entegrasyonu için gerekli ayar bilgileri.
  • query (String – zorunlu): Arama kriteri. Örn: "name contains 'Rapor'", "mimeType='application/pdf'".
  • pageSize (Int32 – opsiyonel): Döndürülecek maksimum dosya sayısı.
• Sonuç: Çoklu (Many) döner → kriterle eşleşen dosyalar listelenir.
• Değer Bağlama:
  
  • Parametreler sabit (Fixed) değer olarak girilebilir.
  • Dinamik değer bağlama için Symbol Picker kullanılabilir (ör. kullanıcı girişine göre query oluşturma).
• Web & Mobil Desteği: Hem web hem de mobil uygulamalarda kullanılabilir.

Google Drive Search Files Uygulama Adımları

1. Aksiyon Ekleme

• Kuika platformunda projenizi açın.
• UI Design modülünde bir arama alanı ekleyin.
• Arama butonuna + ADD ACTION → Google → Google Drive Search Files aksiyonunu ekleyin.

2. Parametreleri Yapılandırma

• settings (zorunlu): Google Drive entegrasyonu için ayarlar seçilir.
• query (zorunlu):
  
  • Basit kullanım → "name contains '2025'".
  • Gelişmiş kullanım → "mimeType='application/vnd.google-apps.spreadsheet' and name contains 'Bütçe'".
• pageSize (opsiyonel): Kaç dosyanın listeleneceğini belirler (örn. 20).

Kullanım Senaryosu: "PDF Raporları Arama"

Bir iş uygulamasında kullanıcı Drive üzerinde PDF raporları bulmak istiyor.

Adımlar:

1. Arama kutusuna “Rapor” yazılır.
2. query: "mimeType='application/pdf' and name contains 'Rapor'".
3. Google Drive Search Files aksiyonu çalışır.
4. Dönen sonuçlar Table elementinde gösterilir.

Google Drive Search Files İleri Seviye Özelleştirmeler

• Dinamik Query: Kullanıcı arama kutusuna yazdığı metin → query parametresine bağlanabilir.
• Sayfalama: pageSize ile dosya listesi kontrol altına alınabilir.
• Zincirleme İşlem: Dönen dosya ID’leri → Google Drive Get File Content aksiyonuna aktarılabilir.

Teknik Riskler ve Kontroller

• query boş bırakılırsa Drive’daki tüm dosyalar dönebilir → performans düşer.
• Yanlış yazılan mimeType veya filtreler sonuç getirmeyebilir.
• Çok büyük pageSize değerleri (örn. 1000+) performans sorunlarına yol açabilir.