Events: watch

Etkinlik 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 kullanın. Şu anda giriş yapmış olan kullanıcının birincil takvimine erişmek istiyorsanız "primary" anahtar kelimesini kullanın.
İsteğe bağlı sorgu parametreleri
eventTypes string İzlenecek etkinlik kaynakları. İsteğe bağlı. Bu parametre, farklı türdeki kaynakları izlemek için birden çok kez tekrarlanabilir. Ayarlanmazsa tüm etkinlik türlerini döndürür.

Kabul edilen değerler şunlardır:
  • "default": Normal etkinlikler.
  • "focusTime": Etkinliklere odaklan.
  • "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

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

İstek içeriği

İstek gövdesinde, verileri aşağıdaki yapıyla 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 her bildirimle birlikte hedef adrese gönderilen rastgele dize. İsteğe bağlı.
type string Bu kanal için kullanılan yayınlama mekanizmasının türü. Geçerli değerler "web_hook" (veya "webhook") değerleridir. Her iki değer de mesaj göndermek için Http isteklerinin kullanıldığı bir kanalı ifade eder.
address string Bu kanal için bildirimlerin gönderildiği adrestir.
params object Yayınlama kanalı davranışını kontrol eden ek parametreler. İsteğe bağlı.
params.ttl string Bildirim kanalının saniye cinsinden geçerlilik süresi. Varsayılan değer 604.800 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 Bunu, "api#channel" adlı kaynakta yapılan değişiklikleri 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ı.
resourceUri string İzlenen kaynağın sürüme özgü tanımlayıcısı.
token string Bu kanal üzerinden her bildirimle birlikte hedef adrese gönderilen rastgele dize. İsteğe bağlı.
expiration long Bildirim kanalının süre sonunun milisaniye cinsinden, Unix zaman damgası olarak ifade edilen tarih ve saat. İsteğe bağlı.