Calendar API, hatırlatıcılar ve bildirimler için destek sağlar.
- Hatırlatıcılar, bir etkinlik başlamadan önce belirtilen bir zamanda tetiklenen alarmlardır.
- Bildirimler, kullanıcıların takvimlerindeki etkinliklerde yapılan değişiklikler hakkında bilgi edinmelerine olanak tanır.
İkinci öğe, bir kullanıcıya gönderilmek yerine takvimdeki değişiklikleri başka bir sunucuya bildiren push bildirimleri ile karıştırılmamalıdır.
Google Takvim'deki bildirimler hakkında daha fazla bilgi için Google Takvim bildirimlerini değiştirme başlıklı makaleyi inceleyin.
Hatırlatıcılar
Hatırlatıcılar şunları içerir:
- Hatırlatıcının gösterileceği zaman (etkinlik başlangıç zamanından kaç dakika önce gösterileceği şeklinde ifade edilir)
- Kullanılacak yayın yöntemi (Yayın mekanizmaları bölümüne bakın)
Hatırlatıcılar, takvimlerin tamamı ve tek tek etkinlikler için belirtilebilir. Kullanıcılar, takvimlerinin her biri için varsayılan hatırlatıcılar ayarlayabilir. Bu varsayılan ayarlar, ilgili takvimdeki tüm etkinlikler için geçerli olur. Ancak kullanıcılar, etkinlikler için bu varsayılanları geçersiz kılabilir ve farklı bir hatırlatıcı grubuyla değiştirebilir.
Varsayılan hatırlatıcılar
Hatırlatıcılar, kimliği doğrulanmış bir kullanıcıya özgü gizli bilgilerdir ve birden fazla kullanıcı arasında paylaşılmazlar. Bu nedenle:
- Varsayılan hatırlatıcılar, kullanıcıya özel takvim meta verilerini içeren CalendarList koleksiyonu aracılığıyla değiştirilir.
- Bu verilere, tüm kullanıcılar arasında paylaşılan genel meta verileri içeren Takvimler koleksiyonu üzerinden erişilemez.
Varsayılan hatırlatıcılar, etkinlik listesi sorgusu yapılırken de döndürülür.
Varsayılan hatırlatıcıları geçersiz kılma
Bir etkinlik eklerken veya değiştirirken varsayılan hatırlatıcıları geçersiz kılmak için reminders.useDefault parametresini false
olarak ayarlayın ve reminders.overrides parametresini yeni hatırlatıcı grubuyla doldurun.
"reminders": {
"useDefault": false,
# Overrides can be set if and only if useDefault is false.
"overrides": [
{
"method": "reminderMethod",
"minutes": "reminderMinutes"
},
# ...
]
}
Varsayılan hatırlatıcı grubuna geri dönmek için reminders.useDefault ayarını true
olarak güncelleyin.
Bildirimler
Takvim aşağıdaki bildirim türlerini destekler:
- Etkinlik oluşturma: Kullanıcının takvimlerinden birine yeni bir etkinlik eklenir.
- Etkinlik değişikliği: Düzenleyici, kullanıcının davet edildiği bir etkinliği değiştirdi.
- Etkinlik iptalleri: Kullanıcının davet edildiği bir etkinlik iptal edilir.
- Katılımcı yanıtı: Kullanıcı tarafından oluşturulan bir etkinliğin katılımcısı, yanıt durumunu değiştirdi.
- Gündem: Kullanıcının takvimindeki tüm etkinliklerin gün başında gönderilen listesi.
Kullanıcı, takvim başına hangi bildirimlerin etkinleştirileceğine ve her bildirim türü için teslimat yöntemine karar verebilir. Bu ayarlar diğer kullanıcılarla paylaşılmaz. Varsayılan hatırlatıcılara benzer şekilde, bunlara CalendarList koleksiyonu üzerinden erişilebilir.
API aracılığıyla eklenen veya güncellenen etkinliklerle ilgili olarak katılımcılara e-posta bildirimleri göndermek için ekleme/güncelleme isteğinde sendNotifications
parametresini doğru olarak ayarlayın.
Yayınlanma mekanizmaları
Google Takvim'in sunduğu yayınlama yöntemleri:
- Pop-up. Bunlar mobil platformlarda ve web istemcilerinde desteklenir.
- Sunucu tarafından gönderilen e-posta.
Aşağıdaki tabloda, her hatırlatıcı veya bildirim türü için desteklenen yöntemler gösterilmektedir:
Pop-up | E-posta | ||
---|---|---|---|
Hatırlatıcılar | Varsayılan hatırlatıcılar | ✓ | ✓ |
Hatırlatıcıları geçersiz kılma | ✓ | ✓ | |
Bildirimler | Etkinlik oluşturma | ❌ | ✓ |
Etkinlik değişikliği | ❌ | ✓ | |
Etkinlik iptali | ❌ | ✓ | |
Katılımcı yanıtı | ❌ | ✓ | |
Gündem | ❌ | ✓ |