Google Calendar Node

Google Calendar node'u, SkyStudio workflow'larında Google Takvim ile entegrasyon sağlar. Etkinlikleri okuyabilir, oluşturabilir, güncelleyebilir ve silebilir; AI destekli doğal dil sorguları çalıştırabilirsiniz.

---

🎬 Videoyu izlemek için tıklayın →

Bağlantı Kurulumu ve Yönetimi

Google Calendar node'unu kullanabilmek için önce bir Google hesabı bağlantısı oluşturmanız gerekir.

Yeni Bağlantı Ekleme

1. SkyStudio'nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
2. Yeni Bağlantı Ekle butonuna tıklayın.
3. Sağlayıcı olarak Google Calendar seçin.
4. Google ile Yetkilendir butonuna tıklayın.
5. Açılan Google OAuth penceresinde hesabınızı seçin ve gerekli izinlere onay verin.
6. Yetkilendirme tamamlandığında bağlantı otomatik olarak kaydedilir.

Not: Google Calendar node'u OAuth 2.0 protokolü kullanır. Şifreniz SkyStudio'ya iletilmez; yalnızca Google tarafından verilen erişim token'ı saklanır.

Bağlantıyı Node'a Atama

Google Calendar node'unu canvas'a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden daha önce oluşturduğunuz Google hesabı bağlantısını seçin.

Calendar ID Nedir?

Calendar ID, hangi takvimin kullanılacağını belirtir.

Değer	Açıklama
primary	Google hesabınızdaki varsayılan (birincil) takvim
kullanici@gmail.com	Belirli bir takviminizin e-posta adresi
Özel ID	Google Takvim ayarlarından kopyalanan benzersiz takvim kimliği

Takviminizin ID'sini öğrenmek için: Google Takvim → Takvim Ayarları → "Takvim entegrasyon" bölümü → Takvim Kimliği alanı.

---

Operasyonlar

Google Calendar node'u 9 operasyon sunmaktadır:

Operasyon	Kategori	Açıklama
Etkinlikleri Getir	Öne Çıkan	Belirli tarih aralığındaki etkinlikleri listeler
Bugünün Etkinlikleri	Öne Çıkan	Bugünkü tüm etkinlikleri getirir
Yaklaşan Etkinlikler	Öne Çıkan	Önümüzdeki günlerdeki etkinlikleri listeler
Google Takvim AI Asistan	Öne Çıkan	Doğal dil sorgusuyla takvim verilerini sorgular
Takvimleri Listele	Standart	Hesaptaki tüm takvimleri listeler
Etkinlik Getir	Standart	ID ile tek bir etkinliğin detaylarını getirir
Etkinlik Oluştur	Standart	Yeni bir takvim etkinliği oluşturur
Etkinlik Güncelle	Standart	Mevcut bir etkinliği günceller
Etkinlik Sil	Standart	Bir etkinliği takvimden siler

---

Etkinlikleri Getir

Belirtilen tarih aralığındaki takvim etkinliklerini döndürür. Raporlama ve etkinlik filtreleme senaryolarında kullanılır.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google hesabı bağlantısı
Calendar ID	Evet	Etkinliklerin alınacağı takvim kimliği (örn. primary)
Start Date	Hayır	Arama başlangıç tarihi — elle girilebilir, format: 2024-06-01T00:00:00
End Date	Hayır	Arama bitiş tarihi — elle girilebilir, format: 2024-06-30T23:59:59
Search Query	Hayır	Başlık veya açıklamada aranacak metin
Max Results	Hayır	Döndürülecek maksimum etkinlik sayısı
Order By	Hayır	Sıralama kriteri (startTime veya updated)

Örnek Çıktı

{
  "items": [
    {
      "id": "abc123xyz",
      "summary": "Proje Toplantısı",
      "start": { "dateTime": "2024-11-15T10:00:00" },
      "end": { "dateTime": "2024-11-15T11:00:00" },
      "location": "Toplantı Odası 1",
      "status": "confirmed"
    }
  ]
}

---

Bugünün Etkinlikleri

Seçilen takvimde bugün gerçekleşecek tüm etkinlikleri otomatik olarak getirir. Tarih parametresi girmeden günlük özet almak için idealdir.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google hesabı bağlantısı
Calendar ID	Evet	Etkinliklerin alınacağı takvim kimliği
Timezone	Hayır	Günün sınırlarını belirlemek için kullanılan zaman dilimi (örn. Europe/Istanbul)

İpucu: Zaman dilimi belirtilmezse UTC kullanılır. Türkiye'de çalışan workflow'lar için Europe/Istanbul değerini girin.

---

Yaklaşan Etkinlikler

Şu andan itibaren belirtilen gün sayısı içindeki etkinlikleri getirir. Hatırlatıcı ve bildirim workflow'ları için uygundur.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google hesabı bağlantısı
Calendar ID	Evet	Etkinliklerin alınacağı takvim kimliği
Days Ahead	Hayır	Kaç gün ilerisi taranacak (örn. 7 = önümüzdeki 1 hafta)
Max Results	Hayır	Döndürülecek maksimum etkinlik sayısı

---

Google Takvim AI Asistan

Doğal dil kullanarak takvim verilerini sorgulamanızı sağlar. Karmaşık tarih/saat filtreleri yazmadan bilgiye ulaşmak için idealdir.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google hesabı bağlantısı
Query	Evet	Doğal dilde sorgulama sorusu
System Prompt	Hayır	AI asistanının davranışını özelleştiren sistem talimatı

Kullanım Örneği

Query: "Bu hafta sonu kaç toplantım var?"

System Prompt: "Yalnızca 'Toplantı' veya 'Meeting' kelimesini içeren etkinlikleri say."

İpucu: System Prompt ile AI asistanına belirli takvimler, kişiler veya etkinlik kategorileri gibi kısıtlamalar tanımlayabilirsiniz.

---

Takvimleri Listele

Google hesabınıza bağlı tüm takvimleri (kişisel, paylaşılan, ekip takvimleri vb.) döndürür. Hangi takvimlere erişiminiz olduğunu ve Calendar ID değerlerini öğrenmek için kullanılır.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google hesabı bağlantısı

Örnek Çıktı

{
  "items": [
    {
      "id": "primary",
      "summary": "Ahmet Yılmaz",
      "primary": true,
      "accessRole": "owner"
    },
    {
      "id": "tr.turkish#holiday@group.v.calendar.google.com",
      "summary": "Türkiye'deki Tatiller",
      "accessRole": "reader"
    }
  ]
}

---

Etkinlik Getir

Belirli bir Event ID ile tek bir takvim etkinliğinin tüm detaylarını getirir.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google hesabı bağlantısı
Calendar ID	Evet	Etkinliğin bulunduğu takvim kimliği
Event ID	Evet	Getirilecek etkinliğin Google Calendar ID'si

Event ID Nasıl Bulunur?

"Etkinlikleri Getir" veya "Bugünün Etkinlikleri" operasyonlarından dönen çıktıdaki id alanı, o etkinliğin Event ID'sidir. Google Calendar web arayüzünde etkinliği açıp URL'den de kopyalanabilir.

---

Etkinlik Oluştur

Google Takvim'de yeni bir etkinlik oluşturur. Katılımcı davetleri, konum ve tüm gün etkinlikleri desteklenir.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google hesabı bağlantısı
Calendar ID	Evet	Etkinliğin oluşturulacağı takvim kimliği
Title	Evet	Etkinlik başlığı
Description	Hayır	Etkinlik açıklaması veya notları
Start Date Time	Evet	Başlangıç tarihi ve saati — elle girilebilir, format: 2024-06-01T10:00:00
End Date Time	Evet	Bitiş tarihi ve saati — elle girilebilir, format: 2024-06-01T11:00:00
Timezone	Hayır	Etkinliğin zaman dilimi (örn. Europe/Istanbul)
Location	Hayır	Etkinlik konumu (adres veya mekan adı)
Attendees	Hayır	Davet edilecek katılımcıların e-posta adresleri (virgülle ayrılmış)
All Day Event	Hayır	Tüm gün etkinliği olarak işaretler (açıksa saat bilgisi yok sayılır)

Attendees Kullanımı

Birden fazla katılımcı eklemek için e-posta adreslerini virgülle ayırın:

ali@sirket.com, ayse@sirket.com, mehmet@ortak.com

Her katılımcıya otomatik olarak Google Takvim daveti gönderilir.

All Day Event Modu

All Day Event açıkken Start Date Time ve End Date Time alanlarına yine aynı format kullanılır (2024-12-31T00:00:00), ancak saat bilgisi dikkate alınmaz; etkinlik tüm gün olarak işaretlenir.

---

Etkinlik Güncelle

Mevcut bir takvim etkinliğinin bilgilerini günceller. Yalnızca girilen alanlar değiştirilir; girilmeyen alanlar mevcut değerleriyle korunur.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google hesabı bağlantısı
Calendar ID	Evet	Etkinliğin bulunduğu takvim kimliği
Event ID	Evet	Güncellenecek etkinliğin ID'si
Title	Hayır	Yeni etkinlik başlığı
Description	Hayır	Yeni açıklama veya notlar
Start Date Time	Hayır	Yeni başlangıç tarihi ve saati
End Date Time	Hayır	Yeni bitiş tarihi ve saati
Timezone	Hayır	Yeni zaman dilimi
Location	Hayır	Yeni konum bilgisi
Attendees	Hayır	Güncellenmiş katılımcı listesi (virgülle ayrılmış e-postalar)

Uyarı: Attendees alanı girildiğinde mevcut katılımcı listesinin tamamı yeni liste ile değiştirilir. Var olan katılımcıları korumak istiyorsanız önce "Etkinlik Getir" ile mevcut listeyi alıp üzerine ekleyin.

---

Etkinlik Sil

Bir takvim etkinliğini kalıcı olarak siler. Bu işlem geri alınamaz.

Parametreler

Parametre	Zorunlu	Açıklama
Connection	Evet	Kullanılacak Google hesabı bağlantısı
Calendar ID	Evet	Etkinliğin bulunduğu takvim kimliği
Event ID	Evet	Silinecek etkinliğin ID'si

Uyarı: Silme işlemi kalıcıdır ve geri alınamaz. Silmeden önce Event ID'nin doğru olduğundan emin olun.

---

Hızlı Başlangıç Örnekleri

Örnek 1: Günlük Toplantı Özeti

Her sabah bugünkü toplantıları özetleyip Slack'e gönderen workflow:

Schedule (Her sabah 08:00) → Bugünün Etkinlikleri → LLM (özetle) → Slack Mesajı

Bugünün Etkinlikleri ayarları:

• Calendar ID: primary
• Timezone: Europe/Istanbul

---

Örnek 2: Otomatik Toplantı Planlayıcı

Kullanıcının yazdığı toplantı bilgisine göre otomatik etkinlik oluşturan workflow:

Metin Girişi → LLM (bilgileri parse et) → Etkinlik Oluştur → Onay Mesajı

Etkinlik Oluştur ayarları:

• Calendar ID: primary
• Title: {{llm.output.title}}
• Start Date Time: {{llm.output.start}}
• End Date Time: {{llm.output.end}}
• Attendees: {{llm.output.attendees}}
• Timezone: Europe/Istanbul

---

Örnek 3: Yaklaşan Etkinlik Hatırlatıcısı

Önümüzdeki 24 saat içindeki etkinlikler için e-posta hatırlatması gönderen workflow:

Schedule (Her gün 09:00) → Yaklaşan Etkinlikler → Koşul (etkinlik var mı?) → E-posta Gönder

Yaklaşan Etkinlikler ayarları:

• Calendar ID: primary
• Days Ahead: 1
• Max Results: 10

---

Örnek 4: Doğal Dil Takvim Asistanı

Kullanıcının sorularını doğal dilde yanıtlayan takvim chatbot'u:

Metin Girişi → Google Takvim AI Asistan → Metin Çıktısı

Google Takvim AI Asistan ayarları:

• Query: {{input.text}}
• System Prompt: "Kullanıcının takvimiyle ilgili sorularını Türkçe yanıtla. Tarih ve saat bilgilerini Türkiye saatiyle ver."

---

Sık Karşılaşılan Hatalar

Hata	Olası Neden	Çözüm
401 Unauthorized	OAuth token süresi dolmuş veya iptal edilmiş	Bağlantı ayarlarından Google hesabını yeniden yetkilendirin
403 Forbidden	Takvime yazma izni yok	Google Takvim'de takvim izinlerini kontrol edin
404 Not Found	Geçersiz Calendar ID veya Event ID	"Takvimleri Listele" ile doğru Calendar ID'yi kontrol edin
409 Conflict	Aynı Event ID ile çakışan etkinlik	Yeni bir etkinlik oluştururken mevcut Event ID kullanmaktan kaçının
Invalid time range	Start Date Time, End Date Time'dan sonra	Başlangıç tarihinin bitiş tarihinden önce olduğunu kontrol edin
Calendar not found	Yanlış veya erişilemeyen Calendar ID	Hesabın ilgili takvime erişim iznine sahip olduğunu doğrulayın

---

Notlar

• Tüm tarih/saat değerleri YYYY-MM-DDTHH:MM:SS formatında girilmelidir, örn. 2024-06-01T10:00:00. Bu alanlara değer elle yazılabilir veya / ile parametre bağlanabilir. Timezone offset (+03:00 gibi) datetime string'ine eklenmez; zaman dilimi ayrıca Timezone alanından belirtilir.
• Timezone alanı için geçerli değerler IANA zaman dilimi veritabanına dayanır. Türkiye için Europe/Istanbul kullanın.
• Google Calendar API'si saniyede 10 istek sınırına sahiptir. Çok sayıda etkinlik işleyen workflow'larda istekler arasına gecikme (delay) eklemeniz önerilir.
• Tekrarlayan etkinliklerde (recurring events) Etkinlik Sil yalnızca ilgili tek örneği siler; tüm seriyi silmek için Google Takvim arayüzünü kullanın.
• All Day Event açık olduğunda Timezone ayarı dikkate alınmaz.