Calendar API, hatırlatıcılar ve bildirimler için destek sağlar.
- Hatırlatıcılar, bir etkinlik başlamadan önce belirli bir zamanda tetiklenen alarmlardır.
- Bildirimler, kullanıcıların takvimlerindeki etkinliklerde yapılan değişiklikleri öğrenmelerini sağlar.
İkincisi, kullanıcıya gönderilmek yerine başka bir sunucuyu takvimdeki değişiklikler konusunda bilgilendiren push bildirimleriyle 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 şunlardan oluşur:
- Hatırlatıcının ne zaman gösterileceği (etkinlik başlangıç saatinden kaç dakika önce)
- Kullanılacak yayınlanma yöntemi (Yayınlanma mekanizmaları bölümüne bakın)
Hatırlatıcılar, takvimlerin tamamı ve tek tek etkinlikler için belirtilebilir. Kullanıcılar, her takvimleri için varsayılan hatırlatıcılar ayarlayabilir. Bu varsayılanlar, ilgili takvimdeki tüm etkinlikler için geçerlidir. Ancak kullanıcılar, bu varsayılanları tek tek etkinlikler için 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 özel gizli bilgilerdir ve birden fazla kullanıcıyla paylaşılmaz. Bu nedenle:
- Varsayılan hatırlatıcılar, kullanıcıya özel takvim meta verilerini içeren CalendarList koleksiyonu aracılığıyla işlenir.
- Bu veriler, tüm kullanıcılarla paylaşılan genel meta verileri içeren Takvimler koleksiyonu üzerinden erişilemez.
Etkinlik listesi sorgusu yaparken varsayılan hatırlatıcılar da döndürülür.
Varsayılan hatırlatıcıları geçersiz kılma
Bir etkinlik eklediğinizde veya değiştirdiğinizde varsayılan hatırlatıcıları geçersiz kılmak için reminders.useDefault değerini false olarak ayarlayın ve reminders.overrides değerini 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 eklendiğinde
- Etkinlik değişikliği: Düzenleyen, kullanıcının davetli olduğu bir etkinliği değiştirdi.
- Etkinlik iptali: Kullanıcının davet edildiği bir etkinlik iptal edildiğinde.
- Katılımcı yanıtı: Kullanıcı tarafından oluşturulan bir etkinliğe katılan bir kullanıcı, yanıt durumunu değiştirdi.
- Gündem: Kullanıcının takvimindeki tüm etkinliklerin listesi, günün başında gönderilir.
Kullanıcı, takvim başına hangi bildirimlerin etkinleştirileceğine ve her bildirim türü için hangi teslimat yönteminin kullanılacağına karar verebilir. Bu ayarlar diğer kullanıcılarla paylaşılmaz. Varsayılan hatırlatıcılara benzer şekilde, CalendarList koleksiyonu üzerinden erişilebilirler.
API ile eklenen veya güncellenen etkinlikler için katılımcılara e-posta bildirimi göndermek üzere insert veya update yöntemini çağırın ve sendUpdates parametresini "all" ya da "externalOnly" olarak ayarlayın.
Yayınlanma mekanizmaları
Google Takvim'in sunduğu teslimat yöntemleri şunlardır:
- Pop-up. Bu özellikler mobil platformlarda ve web istemcilerinde desteklenir.
- Sunucu tarafından gönderilen e-posta.
Aşağıdaki tabloda, her hatırlatma 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 | ❌ | ✓ |