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ı. Bu parametre, farklı türde kaynakları izlemek için 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 kapsamlardan en az biriyle yetkilendirmeye izin verir:

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
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.events.freebusy
https://www.googleapis.com/auth/calendar.events.owned
https://www.googleapis.com/auth/calendar.events.owned.readonly
https://www.googleapis.com/auth/calendar.events.public.readonly

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 benzer 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 gönderildiğ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 metni 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ı.