Settings: watch

सेटिंग के संसाधनों में होने वाले बदलावों पर नज़र रखें.

अनुरोध

एचटीटीपी अनुरोध

POST https://www.googleapis.com/calendar/v3/users/me/settings/watch

पैरामीटर

पैरामीटर का नाम वैल्यू ब्यौरा

अनुमति देना

इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति देना ज़रूरी है:

दायरा
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.settings.readonly
https://www.googleapis.com/auth/calendar.settings

ज़्यादा जानकारी के लिए, पुष्टि और अनुमति पेज देखें.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल करें:

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}
प्रॉपर्टी का नाम वैल्यू ब्यौरा नोट
id string यूयूआईडी या मिलती-जुलती यूनीक स्ट्रिंग, जिससे इस चैनल की पहचान की जाती है.
token string इस चैनल पर डिलीवर की जाने वाली हर सूचना के साथ, टारगेट पते पर डिलीवर की जाने वाली आर्बिट्रेरी स्ट्रिंग. ज़रूरी नहीं.
type string इस चैनल के लिए इस्तेमाल किए गए डिलीवरी मैकेनिज़्म का टाइप. मान्य वैल्यू "web_hook" (या "webhook") हैं. दोनों वैल्यू, ऐसे चैनल के बारे में बताती हैं जहां मैसेज डिलीवर करने के लिए, एचटीटीपी अनुरोधों का इस्तेमाल किया जाता है.
address string वह पता जिस पर इस चैनल के लिए सूचनाएं भेजी जाती हैं.
params object डिलीवरी चैनल के व्यवहार को कंट्रोल करने वाले अतिरिक्त पैरामीटर. ज़रूरी नहीं.
params.ttl string सूचना चैनल के लिए, टाइम-टू-लाइव सेकंड में. डिफ़ॉल्ट रूप से, यह 6,04,800 सेकंड पर सेट होता है.

जवाब

अगर यह तरीका सही से काम करता है, तो जवाब के मुख्य हिस्से में नीचे दिया गया स्ट्रक्चर शामिल होता है:

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}
प्रॉपर्टी का नाम वैल्यू ब्यौरा नोट
kind string इसकी पहचान, सूचना के चैनल के तौर पर की जाती है. इसका इस्तेमाल, "api#channel" संसाधन में होने वाले बदलावों पर नज़र रखने के लिए किया जाता है.
id string यूयूआईडी या मिलती-जुलती यूनीक स्ट्रिंग, जिससे इस चैनल की पहचान की जाती है.
resourceId string एक ओपेक आईडी, जिससे इस चैनल पर देखे जा रहे संसाधन की पहचान होती है. एपीआई के अलग-अलग वर्शन के साथ काम करता है.
resourceUri string देखे गए संसाधन के लिए, वर्शन के हिसाब से आइडेंटिफ़ायर.
token string इस चैनल पर डिलीवर की जाने वाली हर सूचना के साथ, टारगेट पते पर डिलीवर की जाने वाली आर्बिट्रेरी स्ट्रिंग. ज़रूरी नहीं.
expiration long सूचना के चैनल की समयसीमा खत्म होने की तारीख और समय. इसे मिलीसेकंड में, यूनिक्स टाइमस्टैंप के तौर पर दिखाया जाता है. ज़रूरी नहीं.