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şikliklerle ilgili bilgi almalarına olanak tanır.
Bu ikinci öğe, kullanıcıya teslim edilmek yerine, bir takvimdeki değişiklikleri başka bir sunucuya bildiren 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 gösterileceği zaman (etkinlik başlangıç zamanından dakika önceki dakika olarak ifade edilir)
- Kullanılacak yayınlanma yöntemi (İletim 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çerlidir. Ancak kullanıcılar ayrıca her bir etkinlik için bu varsayılanları geçersiz kılarak bunları farklı bir hatırlatıcı grubuyla değiştirebilir.
Varsayılan hatırlatıcılar
Hatırlatıcılar, kimliği doğrulanmış kullanıcıya özel gizli bilgilerdir ve birden çok kullanıcıyla paylaşılmaz. Bu nedenle:
- Varsayılan hatırlatıcılar, kullanıcıya özel takvim meta verileri içeren CalendarList koleksiyonu aracılığıyla değiştirilir.
- Bu takvime, tüm kullanıcılar arasında paylaşılan genel meta verileri içeren Takvimler koleksiyonu üzerinden erişilemez.
Etkinlik listesi sorgusu yapılırken varsayılan hatırlatıcılar da döndürülür.
Varsayılan hatırlatıcıları geçersiz kılma
Bir etkinlik eklerken veya etkinliği değiştirirken varsayılan hatırlatıcıları geçersiz kılmak için reminders.useDefault değerini false olarak ayarlayın ve reminders.overrides'i 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 güncelleme ayarını true değerine geri döndürün.
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ının davet edildiği bir etkinliği değiştirdi.
- 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 ve günün başında gönderilir.
Her takvimde hangi bildirimlerin etkinleştirileceğine ve her bildirim türü için teslim yöntemine kullanıcı karar verebilir. Bu ayarlar diğer kullanıcılarla paylaşılmaz. Varsayılan hatırlatıcılara benzer şekilde bu hatırlatıcılara da CalendarList koleksiyonundan erişilebilir.
API aracılığıyla eklenen veya güncellenen etkinlikler hakkında katılımcılara e-posta bildirimi göndermek için ekleme/güncelleme isteğindeki sendNotifications parametresini "doğru" olarak ayarlayın.
İletim mekanizmaları
Google Takvim tarafından sunulan iletim 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 bir 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 | ❌ | ✓ |