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:
|
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ı. |