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şikliklerle ilgili bilgi almalarına olanak tanır.
İkinci öğe, bir kullanıcıya gönderilmek yerine bir 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ı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, 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 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ştirdi.
- 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 etkinliklerle ilgili olarak katılımcılara e-posta bildirimleri göndermek için ekleme/güncelleme isteğinde sendNotifications
parametresini true olarak ayarlayın.
İletim 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 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ılma | ✓ | ✓ | |
Bildirimler | Etkinlik oluşturma | ❌ | ✓ |
Etkinlik değişikliği | ❌ | ✓ | |
Etkinlik iptali | ❌ | ✓ | |
Katılımcı yanıtı | ❌ | ✓ | |
Gündem | ❌ | ✓ |