Events: watch

Etkinlikler kaynaklarında yapılan değişiklikleri takip edin.

İstek

HTTP isteği

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/watch

Parametreler

Parametre adı Değer Açıklama
Yol parametreleri
calendarId string Takvim tanımlayıcısı. Takvim kimliklerini almak için calendarList.list yöntemini çağırın. Şu anda oturum açmış kullanıcının birincil takvimine erişmek istiyorsanız "primary" anahtar kelimesini kullanın.
İsteğe bağlı sorgu parametreleri
eventTypes string İzlenecek kaynakların etkinlik türleri. İsteğe bağlı. Farklı türlerdeki kaynakları izlemek için bu parametre birden çok kez tekrarlanabilir. Ayarlanmazsa tüm etkinlik türlerini döndürür.

Kabul edilen değerler şunlardır:
  • "birthday": Yıllık olarak tekrarlanan özel tüm gün etkinlikleri.
  • "default": Normal etkinlikler.
  • "focusTime": Odaklanma zamanı etkinlikleri.
  • "fromGmail": Gmail'den etkinlikler.
  • "outOfOffice": Ofis dışında etkinlikleri.
  • "workingLocation": Çalışma yeri etkinlikleri.

Yetkilendirme

Bu istek, aşağıdaki kapsamların en az biriyle yetkilendirme sağlar:

Kapsam
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events.readonly
https://www.googleapis.com/auth/calendar.events

Daha fazla bilgi için kimlik doğrulama ve yetkilendirme sayfasına bakın.

İstek içeriği

İstek gövdesinde aşağıdaki yapıya sahip veriler sağlayın:

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}
Mülk adı Değer Açıklama Notlar
id string Bu kanalı tanımlayan UUID veya benzeri bir benzersiz dize.
token string Bu kanal üzerinden gönderilen her bildirimde hedef adrese iletilen rastgele bir dize. İsteğe bağlı.
type string Bu kanal için kullanılan yayın mekanizmasının türü. Geçerli değerler "web_hook" (veya "webhook") şeklindedir. Her iki değer de mesaj yayınlamak için Http isteklerinin kullanıldığı bir kanalı ifade eder.
address string Bu kanal için bildirimlerin iletildiği adres.
params object Yayınlama kanalı davranışını kontrol eden ek parametreler. İsteğe bağlı.
params.ttl string Bildirim kanalının saniye cinsinden yayın süresi. Varsayılan değer 604800 saniyedir.

Yanıt

Başarılı olursa bu yöntem, aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}
Mülk adı Değer Açıklama Notlar
kind string Bu kaynağın "api#channel" olan değişikliklerini izlemek için kullanılan bir bildirim kanalı olarak tanımlar.
id string Bu kanalı tanımlayan UUID veya benzer bir benzersiz dize.
resourceId string Bu kanalda izlenen kaynağı tanımlayan opak kimlik. Farklı API sürümlerinde kararlıdır.
resourceUri string İzlenen kaynak için sürüme özgü bir tanımlayıcı.
token string Bu kanal üzerinden gönderilen her bildirimde hedef adrese iletilen rastgele bir dize. İsteğe bağlı.
expiration long Bildirim kanalının geçerlilik süresinin sona erdiği tarih ve saat (milisaniye cinsinden Unix zaman damgası olarak ifade edilir). İsteğe bağlı.