Events: watch

इवेंट संसाधनों में हुए बदलावों पर नज़र रखें.

अनुरोध

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

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

पैरामीटर

पैरामीटर का नाम वैल्यू ब्यौरा
पाथ पैरामीटर
calendarId string कैलेंडर आइडेंटिफ़ायर. कैलेंडर आईडी पाने के लिए, calendarList.list तरीके को कॉल करें. अगर आपको उस उपयोगकर्ता का मुख्य कैलेंडर ऐक्सेस करना है जिसने फ़िलहाल लॉग इन किया हुआ है, तो "primary" कीवर्ड का इस्तेमाल करें.
वैकल्पिक क्वेरी पैरामीटर
eventTypes string देखने के लिए इवेंट के टाइप. ज़रूरी नहीं. अलग-अलग तरह के संसाधनों को देखने के लिए, इस पैरामीटर को कई बार दोहराया जा सकता है. अगर यह नीति सेट नहीं है, तो सभी तरह के इवेंट दिखाता है.

इन वैल्यू को इस्तेमाल किया जा सकता है:
  • "default": नियमित इवेंट.
  • "focusTime": फ़ोकस टाइम इवेंट.
  • "outOfOffice": 'अभी मैं छुट्टी पर हूं' इवेंट.
  • "workingLocation": काम करने की जगह से जुड़े इवेंट.

अनुमति

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

स्कोप
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

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

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

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

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

जवाब

अगर यह तरीका काम करता है, तो यह इस स्ट्रक्चर का इस्तेमाल करके रिस्पॉन्स का मुख्य हिस्सा दिखाता है:

{
  "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 सूचना चैनल के खत्म होने की तारीख और समय, जिसे यूनिक्स टाइमस्टैंप के तौर पर मिलीसेकंड में दिखाया जाता है. ज़रूरी नहीं.