किसी इवेंट को अपडेट करता है. इस तरीके में पैच सिमेंटिक्स काम नहीं करता और हमेशा पूरे इवेंट रिसॉर्स को अपडेट करता है. कुछ हद तक अपडेट करने के लिए, get
के बाद update
लागू करें. ऐसा करने के लिए, इटैग का इस्तेमाल करें, ताकि एलिमेंट अच्छे से परफ़ॉर्म करे.
इसे अभी आज़माएं या उदाहरण देखें.
अनुरोध
एचटीटीपी अनुरोध
PUT 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 को कॉपी करने और नई कॉन्फ़्रेंस बनाने की सुविधा चालू की गई है. इसके लिए, कॉन्फ़्रेंस डेटा के createRequest फ़ील्ड का इस्तेमाल किया जा सकता है. डिफ़ॉल्ट वैल्यू 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 |
ज़्यादा जानकारी के लिए, पुष्टि करने और अनुमति देने से जुड़ा पेज देखें.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इन प्रॉपर्टी के साथ इवेंट का संसाधन उपलब्ध कराएं:
प्रॉपर्टी का नाम | मान | ब्यौरा | नोट |
---|---|---|---|
ज़रूरी प्रॉपर्टी | |||
end |
nested object |
इवेंट के खत्म होने का खास समय. बार-बार होने वाले किसी इवेंट के लिए, यह पहले इंस्टेंस के खत्म होने का समय है. | |
start |
nested object |
इवेंट के शुरू होने का समय. बार-बार होने वाले इवेंट के लिए, यह पहले इंस्टेंस के शुरू होने का समय है. | |
वैकल्पिक प्रॉपर्टी | |||
anyoneCanAddSelf |
boolean |
इवेंट में कोई भी व्यक्ति खुद को शामिल कर सकता है या नहीं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह वैल्यू 'गलत' पर सेट होती है. | लिखा जा सकता है |
attachments[].fileUrl |
string |
अटैचमेंट का यूआरएल लिंक. Google Drive में मौजूद फ़ाइल अटैचमेंट जोड़ने के लिए, उसी फ़ॉर्मैट का इस्तेमाल करें जिसका इस्तेमाल Drive API में, अटैचमेंट जोड़ते समय ज़रूरी है. |
लिखा जा सकता है |
attendees[] |
list |
इवेंट में शामिल लोग. कैलेंडर का इस्तेमाल करने वाले अन्य उपयोगकर्ताओं के साथ इवेंट शेड्यूल करने के बारे में ज़्यादा जानकारी के लिए, मेहमानों के साथ इवेंट वाली गाइड देखें. सेवा खातों में, मेहमानों की सूची अपने-आप भरने के लिए, पूरे डोमेन के लोगों को अपने-आप अधिकार देने की सुविधा का इस्तेमाल करना होगा. | लिखा जा सकता है |
attendees[].additionalGuests |
integer |
अतिरिक्त मेहमानों की संख्या. ज़रूरी नहीं. डिफ़ॉल्ट वैल्यू 0 होती है. | लिखा जा सकता है |
attendees[].comment |
string |
मेहमान की जवाब पर टिप्पणी. ज़रूरी नहीं. | लिखा जा सकता है |
attendees[].displayName |
string |
मेहमान का नाम, अगर उपलब्ध हो. ज़रूरी नहीं. | लिखा जा सकता है |
attendees[].email |
string |
मेहमान का ईमेल पता, अगर उपलब्ध हो. मेहमान को जोड़ते समय यह फ़ील्ड मौजूद होना चाहिए. यह RFC5322 के मुताबिक मान्य ईमेल पता होना चाहिए. किसी मेहमान को जोड़ते समय ज़रूरी है. |
लिखा जा सकता है |
attendees[].optional |
boolean |
क्या यह वैकल्पिक मेहमान है. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह वैल्यू 'गलत' पर सेट होती है. | लिखा जा सकता है |
attendees[].resource |
boolean |
क्या मेहमान कोई संसाधन है. इसे सिर्फ़ तब सेट किया जा सकता है, जब मेहमान को इवेंट में पहली बार जोड़ा गया हो. बाद के बदलावों को अनदेखा कर दिया जाता है. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह वैल्यू 'गलत' पर सेट होती है. | लिखा जा सकता है |
attendees[].responseStatus |
string |
मेहमान के जवाब की स्थिति. संभावित वैल्यू ये हैं:
|
लिखा जा सकता है |
attendeesOmitted |
boolean |
क्या मेहमानों को इवेंट से हटा दिया गया है. किसी इवेंट को वापस लाते समय, ऐसा maxAttendee क्वेरी पैरामीटर से तय की गई पाबंदी की वजह से हो सकता है. किसी इवेंट को अपडेट करते समय, इसकी मदद से सिर्फ़ मीटिंग में हिस्सा लेने वाले का जवाब अपडेट किया जा सकता है. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह वैल्यू 'गलत' पर सेट होती है. |
लिखा जा सकता है |
colorId |
string |
इवेंट का रंग. यह आईडी, कलर डेफ़िनिशन के event सेक्शन में की गई एंट्री को रेफ़र करता है. ( कलर एंडपॉइंट देखें). ज़रूरी नहीं. |
लिखा जा सकता है |
conferenceData |
nested object |
कॉन्फ़्रेंस से जुड़ी जानकारी, जैसे कि Google Meet कॉन्फ़्रेंस का ब्यौरा. नई कॉन्फ़्रेंस की जानकारी डालने के लिए, createRequest फ़ील्ड का इस्तेमाल करें. अगर आपको बदलावों को लागू रखना है, तो इवेंट में बदलाव करने के सभी अनुरोधों के लिए, conferenceDataVersion अनुरोध पैरामीटर को 1 पर सेट करना न भूलें. |
लिखा जा सकता है |
description |
string |
इवेंट के बारे में जानकारी. इसमें एचटीएमएल शामिल हो सकता है. ज़रूरी नहीं. | लिखा जा सकता है |
end.date |
date |
अगर यह पूरे दिन का इवेंट है, तो "yyyy-mm-dd" फ़ॉर्मैट में तारीख. | लिखा जा सकता है |
end.dateTime |
datetime |
समय, तारीख और समय की मिली-जुली वैल्यू के तौर पर (RFC3339 के हिसाब से फ़ॉर्मैट किया गया). अगर timeZone में टाइम ज़ोन साफ़ तौर पर नहीं बताया गया है, तो टाइम ज़ोन ऑफ़सेट करना ज़रूरी है. |
लिखा जा सकता है |
end.timeZone |
string |
वह टाइम ज़ोन जिसमें समय बताया गया है. (IANA टाइम ज़ोन डेटाबेस नाम के रूप में फ़ॉर्मैट किया गया, जैसे "यूरोप/ज़ूरिख़".) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी है. साथ ही, यह उस टाइम ज़ोन के बारे में बताता है जिसमें बार-बार होने वाले इवेंट को बड़ा किया जाता है. किसी एक इवेंट के लिए यह फ़ील्ड ज़रूरी नहीं है. साथ ही, इवेंट के शुरू/खत्म होने के लिए कस्टम टाइम ज़ोन दिखाता है. | लिखा जा सकता है |
extendedProperties.private |
object |
ऐसी प्रॉपर्टी जो इस कैलेंडर पर दिखने वाले इवेंट की कॉपी के लिए निजी होती हैं. | लिखा जा सकता है |
extendedProperties.shared |
object |
ऐसी प्रॉपर्टी जिन्हें इवेंट की कॉपी के बीच दूसरे मेहमानों के साथ शेयर किया जाता है कैलेंडर. | लिखा जा सकता है |
focusTimeProperties |
nested object |
फ़ोकस टाइम इवेंट का डेटा. अगर eventType , focusTime है, तो इस्तेमाल किया जाता है. |
लिखा जा सकता है |
gadget.display |
string |
गैजेट का प्रदर्शन मोड. समर्थन नहीं होना या रुकना. संभावित वैल्यू ये हैं:
|
लिखा जा सकता है |
gadget.height |
integer |
पिक्सल में गैजेट की ऊंचाई. ऊंचाई 0 से बड़ी कोई पूर्णांक होनी चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.iconLink |
string |
गैजेट के आइकॉन का यूआरएल. यूआरएल स्कीम, एचटीटीपीएस होनी चाहिए. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.link |
string |
गैजेट का यूआरएल. यूआरएल स्कीम, एचटीटीपीएस होनी चाहिए. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.preferences |
object |
प्राथमिकताएं पर क्लिक करें. | लिखा जा सकता है |
gadget.title |
string |
गैजेट का टाइटल. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.type |
string |
गैजेट का टाइप. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.width |
integer |
पिक्सल में गैजेट की चौड़ाई. चौड़ाई 0 से बड़ी कोई पूर्णांक होनी चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
guestsCanInviteOthers |
boolean |
क्या आयोजक के अलावा अन्य उपस्थित व्यक्ति इवेंट में अन्य लोगों को आमंत्रित कर सकते हैं. ज़रूरी नहीं. डिफ़ॉल्ट तौर पर, 'सही' होता है. | लिखा जा सकता है |
guestsCanModify |
boolean |
आयोजक के अलावा, अन्य मेहमान इवेंट में बदलाव कर सकते हैं या नहीं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह वैल्यू 'गलत' पर सेट होती है. | लिखा जा सकता है |
guestsCanSeeOtherGuests |
boolean |
क्या आयोजक के अलावा अन्य उपस्थित लोग यह देख सकते हैं कि इवेंट के उपस्थित लोग कौन हैं. ज़रूरी नहीं. डिफ़ॉल्ट तौर पर, 'सही' होता है. | लिखा जा सकता है |
location |
string |
फ़्री-फ़ॉर्म टेक्स्ट के तौर पर इवेंट की जगह की जानकारी. ज़रूरी नहीं. | लिखा जा सकता है |
originalStartTime.date |
date |
अगर यह पूरे दिन का इवेंट है, तो "yyyy-mm-dd" फ़ॉर्मैट में तारीख. | लिखा जा सकता है |
originalStartTime.dateTime |
datetime |
समय, तारीख और समय की मिली-जुली वैल्यू के तौर पर (RFC3339 के हिसाब से फ़ॉर्मैट किया गया). अगर timeZone में टाइम ज़ोन साफ़ तौर पर नहीं बताया गया है, तो टाइम ज़ोन ऑफ़सेट करना ज़रूरी है. |
लिखा जा सकता है |
originalStartTime.timeZone |
string |
वह टाइम ज़ोन जिसमें समय बताया गया है. (IANA टाइम ज़ोन डेटाबेस नाम के रूप में फ़ॉर्मैट किया गया, जैसे "यूरोप/ज़ूरिख़".) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी है. साथ ही, यह उस टाइम ज़ोन के बारे में बताता है जिसमें बार-बार होने वाले इवेंट को बड़ा किया जाता है. किसी एक इवेंट के लिए यह फ़ील्ड ज़रूरी नहीं है. साथ ही, इवेंट के शुरू/खत्म होने के लिए कस्टम टाइम ज़ोन दिखाता है. | लिखा जा सकता है |
outOfOfficeProperties |
nested object |
'अभी मैं छुट्टी पर हूं' इवेंट का डेटा. अगर eventType , outOfOffice है, तो इस्तेमाल किया जाता है. |
लिखा जा सकता है |
recurrence[] |
list |
बार-बार होने वाले इवेंट के लिए, RRule, EX बिना, RDATE, और EXDATE लाइनों की सूची, जैसा कि RFC5545 में बताया गया है. ध्यान दें कि इस फ़ील्ड में DTSTART और DTEND लाइनों की अनुमति नहीं है; इवेंट के शुरू और खत्म होने के समय की जानकारी start और end फ़ील्ड में दी गई है. इस फ़ील्ड को किसी एक इवेंट या बार-बार होने वाले इवेंट के लिए इस्तेमाल नहीं किया जाता. |
लिखा जा सकता है |
reminders.overrides[] |
list |
अगर इवेंट में डिफ़ॉल्ट रिमाइंडर का इस्तेमाल नहीं किया गया है, तो इससे इवेंट के लिए खास रिमाइंडर की सूची बनती है. अगर इवेंट में कोई रिमाइंडर सेट नहीं है, तो इससे पता चलता है कि इस इवेंट के लिए कोई रिमाइंडर सेट नहीं है. ओवरराइड रिमाइंडर की ज़्यादा से ज़्यादा संख्या पांच है. | लिखा जा सकता है |
reminders.overrides[].method |
string |
इस रिमाइंडर के लिए इस्तेमाल किया गया तरीका. संभावित वैल्यू ये हैं:
रिमाइंडर जोड़ते समय ज़रूरी है. |
लिखा जा सकता है |
reminders.overrides[].minutes |
integer |
इवेंट शुरू होने से इतने मिनट पहले, रिमाइंडर को ट्रिगर होना चाहिए. मान्य वैल्यू 0 से 40320 के बीच हैं (मिनट में चार हफ़्ते). रिमाइंडर जोड़ते समय ज़रूरी है. |
लिखा जा सकता है |
reminders.useDefault |
boolean |
कैलेंडर के डिफ़ॉल्ट रिमाइंडर इवेंट पर लागू होते हैं या नहीं. | लिखा जा सकता है |
sequence |
integer |
iCalendar के मुताबिक क्रम संख्या. | लिखा जा सकता है |
source.title |
string |
सोर्स का टाइटल; उदाहरण के लिए, किसी वेब पेज का टाइटल या ईमेल का विषय. | लिखा जा सकता है |
source.url |
string |
किसी संसाधन पर ले जाने वाले सोर्स का यूआरएल. यूआरएल स्कीम, एचटीटीपी या एचटीटीपीएस होनी चाहिए. | लिखा जा सकता है |
start.date |
date |
अगर यह पूरे दिन का इवेंट है, तो "yyyy-mm-dd" फ़ॉर्मैट में तारीख. | लिखा जा सकता है |
start.dateTime |
datetime |
समय, तारीख और समय की मिली-जुली वैल्यू के तौर पर (RFC3339 के हिसाब से फ़ॉर्मैट किया गया). अगर timeZone में टाइम ज़ोन साफ़ तौर पर नहीं बताया गया है, तो टाइम ज़ोन ऑफ़सेट करना ज़रूरी है. |
लिखा जा सकता है |
start.timeZone |
string |
वह टाइम ज़ोन जिसमें समय बताया गया है. (IANA टाइम ज़ोन डेटाबेस नाम के रूप में फ़ॉर्मैट किया गया, जैसे "यूरोप/ज़ूरिख़".) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी है. साथ ही, यह उस टाइम ज़ोन के बारे में बताता है जिसमें बार-बार होने वाले इवेंट को बड़ा किया जाता है. किसी एक इवेंट के लिए यह फ़ील्ड ज़रूरी नहीं है. साथ ही, इवेंट के शुरू/खत्म होने के लिए कस्टम टाइम ज़ोन दिखाता है. | लिखा जा सकता है |
status |
string |
इवेंट की स्थिति. ज़रूरी नहीं. संभावित वैल्यू ये हैं:
|
लिखा जा सकता है |
summary |
string |
इवेंट का शीर्षक. | लिखा जा सकता है |
transparency |
string |
इवेंट, कैलेंडर पर समय को ब्लॉक करता है या नहीं. ज़रूरी नहीं. संभावित वैल्यू ये हैं:
|
लिखा जा सकता है |
visibility |
string |
इवेंट किसको दिखे. ज़रूरी नहीं. संभावित वैल्यू ये हैं:
|
लिखा जा सकता है |
workingLocationProperties |
nested object |
काम करने की जगह का इवेंट डेटा. | लिखा जा सकता है |
workingLocationProperties.customLocation |
object |
अगर यह मौजूद हो, तो यह बताता है कि उपयोगकर्ता अपनी पसंद की जगह से काम कर रहा है. | लिखा जा सकता है |
workingLocationProperties.customLocation.label |
string |
अतिरिक्त जानकारी के लिए एक वैकल्पिक अतिरिक्त लेबल. | लिखा जा सकता है |
workingLocationProperties.homeOffice |
any value |
अगर यह जानकारी मौजूद हो, तो इससे पता चलता है कि उपयोगकर्ता घर से काम कर रहा है. | लिखा जा सकता है |
workingLocationProperties.officeLocation |
object |
अगर यह जानकारी मौजूद हो, तो इससे पता चलता है कि उपयोगकर्ता, ऑफ़िस से काम कर रहा है. | लिखा जा सकता है |
workingLocationProperties.officeLocation.buildingId |
string |
इमारत का एक वैकल्पिक आइडेंटिफ़ायर. इसमें संगठन के संसाधन डेटाबेस में मौजूद बिल्डिंग आईडी का रेफ़रंस होना चाहिए. | लिखा जा सकता है |
workingLocationProperties.officeLocation.deskId |
string |
एक वैकल्पिक डेस्क आइडेंटिफ़ायर. | लिखा जा सकता है |
workingLocationProperties.officeLocation.floorId |
string |
मंज़िल का वैकल्पिक आइडेंटिफ़ायर. | लिखा जा सकता है |
workingLocationProperties.officeLocation.floorSectionId |
string |
फ़्लोर सेक्शन का वैकल्पिक आइडेंटिफ़ायर. | लिखा जा सकता है |
workingLocationProperties.officeLocation.label |
string |
कैलेंडर वेब और मोबाइल क्लाइंट में दिखाया गया ऑफ़िस का नाम. हमारा सुझाव है कि आप संगठन के संसाधनों के डेटाबेस में मौजूद इमारत का नाम देखें. | लिखा जा सकता है |
workingLocationProperties.type |
string |
काम करने की जगह का टाइप. संभावित वैल्यू ये हैं:
काम करने की जगह की जानकारी जोड़ने के लिए ज़रूरी है. |
लिखा जा सकता है |
जवाब
अगर इस तरीके से पुष्टि हो जाती है, तो जवाब के मुख्य हिस्से में यह इवेंट का संसाधन दिखाता है.
उदाहरण
ध्यान दें: इस तरीके के लिए दिए गए कोड के उदाहरणों में इसके साथ काम करने वाली सभी प्रोग्रामिंग भाषाएं नहीं दिखाई गई हैं (इसके साथ काम करने वाली भाषाओं की सूची के लिए क्लाइंट लाइब्रेरी वाला पेज देखें).
Java
Java क्लाइंट लाइब्रेरी का इस्तेमाल करता है.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.Event; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Retrieve the event from the API Event event = service.events().get("primary", "eventId").execute(); // Make a change event.setSummary("Appointment at Somewhere"); // Update the event Event updatedEvent = service.events().update("primary", event.getId(), event).execute(); System.out.println(updatedEvent.getUpdated());
Python
Python क्लाइंट लाइब्रेरी का इस्तेमाल किया जाता है.
# First retrieve the event from the API. event = service.events().get(calendarId='primary', eventId='eventId').execute() event['summary'] = 'Appointment at Somewhere' updated_event = service.events().update(calendarId='primary', eventId=event['id'], body=event).execute() # Print the updated date. print updated_event['updated']
PHP
PHP क्लाइंट लाइब्रेरी का इस्तेमाल किया जाता है.
// First retrieve the event from the API. $event = $service->events->get('primary', 'eventId'); $event->setSummary('Appointment at Somewhere'); $updatedEvent = $service->events->update('primary', $event->getId(), $event); // Print the updated date. echo $updatedEvent->getUpdated();
Ruby
Ruby क्लाइंट लाइब्रेरी का इस्तेमाल करता हो.
event = client.get_event('primary', 'eventId') event.summary = 'Appointment at Somewhere' result = client.update_event('primary', event.id, event) print result.updated
इसे आज़माएं!
लाइव डेटा पर इस तरीके को कॉल करने और जवाब देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.