Hatırlatıcılar ve bildirimler

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 CalendarList toplama işlemiyle değiştirilir.
  • Bu veriler, tüm kullanıcılarla paylaşılan genel meta verileri içeren Calendars 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 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