Events: watch

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

अनुरोध

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

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

पैरामीटर

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

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "birthday": पूरे दिन चलने वाले खास इवेंट, जो साल में एक बार होते हैं.
  • "default": नियमित इवेंट.
  • "focusTime": फ़ोकस टाइम इवेंट.
  • "fromGmail": Gmail के इवेंट.
  • "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
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.events.freebusy
https://www.googleapis.com/auth/calendar.events.owned
https://www.googleapis.com/auth/calendar.events.owned.readonly
https://www.googleapis.com/auth/calendar.events.public.readonly

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

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

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

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