इससे किसी इवेंट को अपडेट किया जाता है. यह तरीका, पैच सिमैंटिक्स के साथ काम करता है. ध्यान दें कि पैच के हर अनुरोध के लिए, कोटा की तीन यूनिट खर्च होती हैं. इसलिए, get के बाद update का इस्तेमाल करना बेहतर है. आपके बताए गए फ़ील्ड की वैल्यू, मौजूदा वैल्यू की जगह ले लेती हैं. अनुरोध में जिन फ़ील्ड के बारे में नहीं बताया जाता उनमें कोई बदलाव नहीं होता. अगर ऐरे फ़ील्ड के बारे में बताया जाता है, तो वे मौजूदा ऐरे को ओवरराइट कर देते हैं. इससे, पहले के सभी ऐरे एलिमेंट मिट जाते हैं.
इसे अभी आज़माएं.
अनुरोध
एचटीटीपी अनुरोध
PATCH https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId
पैरामीटर
| पैरामीटर का नाम | मान | ब्यौरा |
|---|---|---|
| पाथ पैरामीटर | ||
calendarId |
string |
कैलेंडर आइडेंटिफ़ायर. कैलेंडर आईडी पाने के लिए, calendarList.list तरीके को कॉल करें. अगर आपको फ़िलहाल लॉग इन किए हुए उपयोगकर्ता के प्राइमरी कैलेंडर का ऐक्सेस चाहिए, तो "primary" कीवर्ड का इस्तेमाल करें.
|
eventId |
string |
इवेंट आइडेंटिफ़ायर. |
| क्वेरी के वैकल्पिक पैरामीटर | ||
alwaysIncludeEmail |
boolean |
अब इस्तेमाल में नहीं है और इसे अनदेखा कर दिया गया है. आयोजक, क्रिएटर, और शामिल होने वाले लोगों के लिए, email फ़ील्ड में हमेशा कोई वैल्यू दिखाई जाएगी.भले ही, कोई असली ईमेल पता उपलब्ध न हो. जैसे, जनरेट की गई ऐसी वैल्यू दिखाई जाएगी जो काम नहीं करती.
|
conferenceDataVersion |
integer |
कॉन्फ़्रेंस डेटा का वर्शन नंबर, जिसे एपीआई क्लाइंट इस्तेमाल कर सकता है. वर्शन 0 में, यह माना जाता है कि कॉन्फ़्रेंस डेटा के लिए कोई सहायता उपलब्ध नहीं है. साथ ही, यह इवेंट के मुख्य भाग में मौजूद कॉन्फ़्रेंस डेटा को अनदेखा करता है. वर्शन 1 में, ConferenceData को कॉपी करने के साथ-साथ, conferenceData के createRequest फ़ील्ड का इस्तेमाल करके नई कॉन्फ़्रेंस बनाने की सुविधा मिलती है. डिफ़ॉल्ट सेटिंग 0 पर सेट होती है.
स्वीकार की जा सकने वाली वैल्यू 0 से 1 तक हैं. इसमें दोनों वैल्यू शामिल हैं.
|
eventLabelVersion |
integer |
इवेंट लेबल की सुविधा का वर्शन नंबर, जिसे एपीआई क्लाइंट इस्तेमाल कर सकता है. वर्शन 0 में, यह माना जाता है कि इवेंट लेबल के लिए कोई सहायता उपलब्ध नहीं है. साथ ही, यह रंग मैनेज करने के लिए colorId फ़ील्ड को प्रोसेस करता है. वर्शन 1 में, इवेंट लेबल की सुविधा मिलती है. साथ ही, यह इवेंट के मुख्य भाग में मौजूद eventLabelId को प्रोसेस करता है. इस मामले में, colorId फ़ील्ड को अनदेखा कर दिया जाता है. डिफ़ॉल्ट सेटिंग 0 पर सेट होती है.
स्वीकार की जा सकने वाली वैल्यू 0 से 1 तक हैं. इसमें दोनों वैल्यू शामिल हैं.
|
maxAttendees |
integer |
जवाब में शामिल किए जाने वाले लोगों की ज़्यादा से ज़्यादा संख्या. अगर शामिल होने वाले लोगों की संख्या, तय की गई संख्या से ज़्यादा है, तो सिर्फ़ हिस्सा लेने वाले व्यक्ति की जानकारी दिखाई जाएगी. ज़रूरी नहीं. |
sendNotifications |
boolean |
अब इस्तेमाल में नहीं है. इसके बजाय, कृपया sendUpdates का इस्तेमाल करें. क्या इवेंट के अपडेट के बारे में सूचनाएं भेजनी हैं? जैसे, जानकारी में बदलाव वगैरह. ध्यान दें कि अगर आपने वैल्यू को false पर सेट किया है, तब भी कुछ ईमेल भेजे जा सकते हैं. डिफ़ॉल्ट सेटिंग false पर सेट होती है.
|
sendUpdates |
string |
ऐसे मेहमान जिन्हें इवेंट के अपडेट के बारे में सूचनाएं मिलनी चाहिए. जैसे, टाइटल में बदलाव वगैरह.
स्वीकार की जा सकने वाली वैल्यू ये हैं:
|
supportsAttachments |
boolean |
क्या एपीआई क्लाइंट, इवेंट में अटैचमेंट जोड़ने की सुविधा के साथ काम करता है. ज़रूरी नहीं. डिफ़ॉल्ट सेटिंग 'गलत' पर सेट होती है. |
अनुमति देना
इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति की ज़रूरत होती है:
| दायरा |
|---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
https://www.googleapis.com/auth/calendar.app.created |
https://www.googleapis.com/auth/calendar.events.owned |
ज़्यादा जानकारी के लिए, अनुमति और पुष्टि करने वाला पेज देखें.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में, Events संसाधन के काम के हिस्सों की जानकारी दें. यह जानकारी, पैच सिमैंटिक्स के नियमों के मुताबिक होनी चाहिए.
जवाब
कामयाब रहने पर, यह तरीका जवाब के मुख्य भाग में Events संसाधन दिखाता है.
इसे आज़माएं!
लाइव डेटा पर इस तरीके को कॉल करने और जवाब देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.