Calendar API, hatırlatıcılar ve bildirimler için destek sağlar.
- Hatırlatıcılar, bir etkinlik başlamadan belirli bir zamanda tetiklenen alarmlardır.
- Bildirimler, kullanıcıların takvimlerindeki etkinliklerde yapılan değişiklikler hakkında bilgi edinmesine olanak tanır.
Sonuncu öğe push bildirimleriyle karıştırılmamalıdır. Bunlar bir takvimdeki değişiklikleri kullanıcıya sunulmak yerine diğer bir sunucuya bildirir.
Google Takvim'deki bildirimler hakkında daha fazla bilgi için Google Takvim bildirimlerini değiştirme başlıklı makaleyi inceleyin.
Hatırlatmalar
Hatırlatıcı şunlardan oluşur:
- Hatırlatıcının gösterilme zamanı (etkinliğin başlangıç zamanından önceki dakika cinsinden)
- 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 bir takvim için varsayılan hatırlatıcılar ayarlayabilir. Bu varsayılan ayarlar, söz konusu takvimdeki tüm etkinlikler için geçerli olur. Bununla birlikte, kullanıcılar bu varsayılanları tek tek etkinlikler için geçersiz kılarak farklı bir hatırlatıcı grubuyla da değiştirebilir.
Varsayılan hatırlatıcılar
Hatırlatıcılar, kimliği doğrulanmış bir kullanıcıya özel gizli bilgilerdir; birden çok kullanıcı arasında paylaşılmaz. Bu nedenle:
- Varsayılan hatırlatıcılar, kullanıcıya özel takvim meta verilerini içeren CalendarList koleksiyonu aracılığıyla
- Bunlara, tüm kullanıcılar arasında paylaşılan genel meta verileri içeren Takvim koleksiyonu üzerinden erişemez.
Bir Etkinlik listesi sorgusu yaptığınızda 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 etkinliği değiştirdiğinizde varsayılan hatırlatıcıları geçersiz kılmak için
reminders.useDefault
öğesini false
olarak ayarlayın ve
reminders.overrides
alanını 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ı tekrar true olacak şekilde 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: Etkinliği düzenleyen kullanıcı, kullanıcının davet edildiği bir etkinliği değiştirmiştir.
- Etkinlik iptali: 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ştirmiştir.
- Ajanda: 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 teslim yöntemine karar verebilir. Bu ayarlar diğer kullanıcılarla paylaşılmaz. Varsayılan hatırlatıcılara benzer şekilde, bu hatırlatıcılara Takvim Listesi koleksiyonu üzerinden erişilebilir.
API aracılığıyla eklenen veya güncellenen etkinlikler için katılımcılara e-posta bildirimi göndermek istiyorsanız ekleme/güncelleme isteğindeki sendNotifications parametresini true olarak ayarlayın.
Yayınlama mekanizmaları
Google Takvim tarafından sunulan teslim yöntemleri şunlardır:
- 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ıl | ✓ | ✓ | |
| Bildirimler | Etkinlik oluşturma | ❌ | ✓ |
| Etkinlik değişikliği | ❌ | ✓ | |
| Etkinlik iptali | ❌ | ✓ | |
| Katılımcı yanıtı | ❌ | ✓ | |
| Gündem | ❌ | ✓ |