Google Calendar List Events aksiyonu, bir Google Takvim’deki etkinlikleri listelemek için kullanılır. Bu aksiyon sayesinde kullanıcıya ait bir takvimde belirli tarih aralıklarındaki tüm etkinlikler alınabilir. Özellikle toplantı planlama, etkinlik hatırlatma, zaman yönetimi ve raporlama senaryolarında tercih edilir.

Teknik Özellikler

• Etkinlikleri Listeleme: Belirtilen takvimdeki (calendarId) etkinlikleri döndürür.
• Parametre Uyumluluğu:
  
  • settings (Object – zorunlu): Google Calendar entegrasyonu için gerekli ayar bilgileri.
  • calendarId (String – zorunlu): Etkinliklerin alınacağı takvim kimliği.
  • startDate (DateTimeOffset – opsiyonel): Etkinliklerin başlangıç tarihi.
  • endDate (DateTimeOffset – opsiyonel): Etkinliklerin bitiş tarihi.
  • resultCount (Int32 – opsiyonel): Döndürülecek maksimum etkinlik sayısı.
  • query (String – opsiyonel): Etkinlik adı, açıklama veya diğer alanlarda arama yapmak için filtre.
• Sonuç: Çoklu sonuç (Many) döner → Birden fazla etkinlik listelenir.
• Değer Bağlama: Parametrelere sabit (Fixed) değer atanabilir veya Symbol Picker aracılığıyla dinamik değerler bağlanabilir.
• Web & Mobil Destek: Hem web hem de mobil uygulamalarda çalışır.

Google Calendar List Events Aksiyonu Uygulama Adımları

1. UI Design’da Aksiyon Tanımlama

• Kuika platformunda projenizi açın.
• UI Design modülünde etkinlik listesini almak istediğiniz ekranı seçin.
• Bir buton ekleyin (ör. “Etkinlikleri Listele”).
• Butonu seçin ve + ADD ACTION menüsünden OnClick → Google →Google Calendar List Events aksiyonunu ekleyin.

2. Parametreleri Yapılandırma

• settings (zorunlu): Google entegrasyonu için tanımlı ayarları seçin.
• calendarId (zorunlu): Örn: primary.
• startDate / endDate (opsiyonel): Etkinliklerin filtreleneceği tarih aralığı (örn: 2025-09-20T00:00:00).
• resultCount (opsiyonel): Örn: 10 → sadece 10 etkinlik döner.
• query (opsiyonel): Belirli etkinlik adlarını aramak için kullanılabilir (örn: “Toplantı”).
• Enable Audit Log (Opsiyonel): Aksiyonun çalıştırılması sırasında gerçekleştirilen işlemlerin audit log kayıtlarına eklenmesini sağlar. Bu sayede sistem üzerinde yapılan değişikliklerin ne zaman, hangi kullanıcı tarafından ve hangi işlem kapsamında gerçekleştiği izlenebilir.

Kullanım Senaryosu: Takvimden Etkinlikleri Listeleme

Bir iş uygulamasında, kullanıcı belirli bir tarih aralığında planlanmış toplantıları görmek istediğinde bu aksiyon kullanılabilir.

Adımlar:

1. UI Design’da başlangıç ve bitiş tarihleri için Date Time Range ekleyin.
2. “Etkinlikleri Listele” butonuna basıldığında Google Calendar List Events aksiyonu tetiklenir.
3. Dönen etkinlikler Table elementi içinde görüntülenir.

Google Calendar List Events İleri Seviye Özelleştirmeler

• Dinamik Filtreleme: Kullanıcı tarih aralığı seçtiğinde etkinlik listesi otomatik yenilenebilir.
• Arama Özelliği: query parametresi ile yalnızca belirli kelimeyi içeren etkinlikler listelenebilir.
• Zincirleme Kullanım: Listeden seçilen eventId, Google Calendar Get Event veya Delete Event aksiyonlarına aktarılabilir.

Teknik Riskler ve Kontroller

• calendarId doğru girilmezse sonuç dönmez.
• startDate / endDate uyumsuz veya boş bırakılırsa tüm etkinlikler dönebilir.
• Çok fazla etkinlik varsa resultCount parametresi ile sınırlandırılmalıdır.