Events: watch

ध्यान दें: अनुमति देना ज़रूरी नहीं है.

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

अनुरोध

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

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

पैरामीटर

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

अनुमति देना

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

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