Events: watch

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

अनुरोध करें

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

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

पैरामीटर

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

अनुमति देना

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

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