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