Events: watch

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

अनुरोध

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

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

पैरामीटर

पैरामीटर का नाम मान ब्यौरा
पाथ पैरामीटर
calendarId string Calendar आइडेंटिफ़ायर. कैलेंडर आईडी वापस पाने के लिए, 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

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

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

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

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