Google Takvim API'si, 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.
Bildirimleri, kullanıcıya gönderilmek yerine takvimdeki değişiklikleri başka bir sunucuya bildiren push bildirimleriyle karıştırmayın.
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 gösterileceği).
- Kullanılacak yayınlanma yöntemi (bkz. Yayınlanma mekanizmaları).
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
CalendarListtoplama işlemiyle değiştirilir. - Bu veriler, tüm kullanıcılarla paylaşılan genel meta verileri içeren
Calendarskoleksiyonu ü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 oluştururken veya güncellerken 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. Aşağıdaki örnekte gösterildiği gibi, geçersiz kılmalar yalnızca useDefault false olduğunda ayarlanabilir:
"reminders": {
"useDefault": false,
"overrides": [
{
"method": "reminderMethod",
"minutes": "reminderMinutes"
}
]
}
Varsayılan hatırlatıcı grubuna 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 davet edildiği 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ı: Bir katılımcı, kullanıcı tarafından oluşturulan bir etkinliğin 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, bu hatırlatıcılara da CalendarList koleksiyonundan erişilebilir.
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" veya "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 | ❌ | ✓ |