Google Drive List Items aksiyonu, Google Drive içindeki dosya ve klasörleri listelemek için kullanılır. Bu aksiyon sayesinde belirli bir klasördeki öğeler alınabilir, sayfalama yapılabilir ve uygulama içinde gösterilebilir. Özellikle dosya yönetimi, belge seçimi ve raporlama senaryolarında tercih edilir.
Teknik Özellikler
Listeleme İşlemi: Belirtilen folderId veya driveId üzerinden dosya ve klasörleri getirir.
Parametre Uyumluluğu:
settings (Object – zorunlu): Google Drive entegrasyonu için gerekli ayar bilgileri.
folderId (String – opsiyonel): Hedef klasör kimliği. Belirtilirse sadece bu klasördeki öğeler listelenir.
driveId (String – opsiyonel): Belirli bir paylaşılan Drive kimliği.
pageSize (Int32 – opsiyonel): Kaç adet öğe listeleneceğini belirler.
Sonuç: Çoklu yanıt (Many) döner → Dosyalar ve klasörlerin bilgileri.
Değer Bağlama: Tüm parametreler sabit (Fixed) değer olarak girilebilir veya Symbol Picker üzerinden dinamik değerlerle bağlanabilir.
Web & Mobil Destek: Hem web hem de mobil uygulamalarda kullanılabilir.
Google Drive List Items Aksiyonu Uygulama Adımları
1. UI Design’da Aksiyon Tanımlama
Kuika platformunda projenizi açın.
UI Design modülünde dosya listeleme yapmak istediğiniz ekranı seçin.
Bir buton ekleyin (ör. “Dosyaları Listele”).
Butonu seçin ve + ADD ACTION → Google →Google Drive List Items aksiyonunu ekleyin.
2. Parametreleri Yapılandırma
settings (zorunlu): Google Drive entegrasyonu için tanımlı ayarları seçin.
folderId (opsiyonel): Sadece belirli klasördeki öğeler listelenecekse buraya klasör kimliği girilir.
driveId (opsiyonel): Paylaşılan sürücülerden listeleme yapmak için kullanılabilir.
pageSize (opsiyonel): Örn: 10 → İlk 10 öğeyi getirir.
Kullanım Senaryosu: “Raporlar” Klasöründeki Dosyaları Listeleme
Bir iş uygulamasında, kullanıcı “Raporlar” klasöründeki dosyaları görmek ister.
Adımlar:
“Dosyaları Listele” butonu ekleyin.
Google Drive List Items aksiyonunda folderId parametresine “Raporlar” klasörünün kimliğini girin.
Dönen sonuçları Table elementinde gösterin.
Google Drive List Items İleri Seviye Özelleştirmeler
Sayfalama: pageSize parametresi ile liste boyutu kontrol edilebilir; sonsuz kaydırma (infinite scroll) senaryosu uygulanabilir.
Filtreleme: Dönen sonuçlar isim, tarih veya dosya tipine göre filtrelenebilir.
Zincirleme Kullanım: Listeden seçilen dosyanın fileId değeri, Google Drive Get File Content aksiyonuna aktarılabilir.
Teknik Riskler ve Kontroller
folderId yanlış girilirse sonuç döndürülmez.
driveId yalnızca paylaşılan Drive kimlikleri için kullanılmalıdır.
pageSize değeri çok büyük seçilirse performans sorunlarına yol açabilir.