किसी इवेंट को अपडेट करता है. इसे अभी आज़माएं या उदाहरण देखें.
अनुरोध करें
एचटीटीपी अनुरोध
PUT https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId
पैरामीटर
पैरामीटर का नाम | वैल्यू | जानकारी |
---|---|---|
पाथ पैरामीटर | ||
calendarId |
string |
कैलेंडर आइडेंटिफ़ायर. कैलेंडर आईडी फिर से पाने के लिए, calendarList.list तरीके पर कॉल करें. फ़िलहाल, लॉग इन किए हुए उपयोगकर्ता के मुख्य कैलेंडर को ऐक्सेस करने के लिए, "primary " कीवर्ड का इस्तेमाल करें.
|
eventId |
string |
इवेंट आइडेंटिफ़ायर. |
वैकल्पिक क्वेरी पैरामीटर | ||
alwaysIncludeEmail |
boolean |
बहिष्कृत और अनदेखा किया गया. वास्तविक ईमेल पता उपलब्ध होने पर भी आयोजक, निर्माता और उपस्थित व्यक्तियों के लिए email फ़ील्ड में मान लौटाया जाएगा (यानी कि जनरेट किया गया, काम न करने वाला मान दिया जाएगा).
|
conferenceDataVersion |
integer |
एपीआई क्लाइंट के साथ काम करने वाले कॉन्फ़्रेंस डेटा का वर्शन नंबर. वर्शन 0 में, कॉन्फ़्रेंस डेटा के लिए कोई सहायता नहीं मिलती है. साथ ही, इवेंट के मुख्य हिस्से में कॉन्फ़्रेंस डेटा को अनदेखा किया जाता है. इस वर्शन 2 में कॉन्फ़्रेंस डेटा को कॉपी किया जा सकता है. साथ ही, कॉन्फ़्रेंस डेटा के CreateRequest फ़ील्ड का इस्तेमाल करके नई कॉन्फ़्रेंस बनाई जा सकती हैं. डिफ़ॉल्ट सेटिंग 0 होती है.
0 से 1 तक के मान स्वीकार किए जाते हैं.
|
maxAttendees |
integer |
जवाब में शामिल होने वाले मेहमानों की ज़्यादा से ज़्यादा संख्या. अगर मीटिंग में शामिल होने वाले लोगों की संख्या, तय संख्या से ज़्यादा है, तो सिर्फ़ उस व्यक्ति को दिखाया जाएगा. ज़रूरी नहीं. |
sendNotifications |
boolean |
समर्थन नहीं होना या रुकना. इसके बजाय, कृपया sendUpdate का इस्तेमाल करें. इवेंट के अपडेट के बारे में सूचनाएं भेजें या नहीं (उदाहरण के लिए, जानकारी में बदलाव वगैरह). ध्यान दें कि भले ही आपने 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 एपीआई में मौजूद अटैचमेंट जोड़ते समय ज़रूरी है. |
लिखा जा सकता है |
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 |
ऐसी प्रॉपर्टी जिन्हें मेहमानों के कैलेंडर पर, इवेंट की कॉपी के बीच शेयर किया जाता है. | लिखा जा सकता है |
gadget.display |
string |
गैजेट का प्रदर्शन मोड. समर्थन नहीं होना या रुकना. वैल्यू इस तरह की हो सकती हैं:
|
लिखा जा सकता है |
gadget.height |
integer |
गैजेट की ऊंचाई पिक्सल में. ऊंचाई 0 से ज़्यादा होना चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.iconLink |
string |
गैजेट के आइकॉन का यूआरएल. यूआरएल स्कीम एचटीटीपीएस होनी चाहिए. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.link |
string |
गैजेट का URL. यूआरएल स्कीम एचटीटीपीएस होनी चाहिए. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
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 समय क्षेत्र डेटाबेस नाम, जैसे "यूरोप/ज़्यूरिख" के रूप में फ़ॉर्मैट किया गया.) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी होता है. साथ ही, यह उस टाइम ज़ोन के बारे में भी बताता है जिसमें दोहराए जाने वाले इवेंट को बढ़ाया जाता है. यह इवेंट वैकल्पिक है और इवेंट के शुरू/खत्म होने के लिए कस्टम समय क्षेत्र दिखाता है. | लिखा जा सकता है |
recurrence[] |
list |
आरएफ़सी5545 में बताए गए किसी बार-बार होने वाले इवेंट के लिए Rनियमों, EXREQUEST, RDATE, और EXDATE लाइनों की सूची. ध्यान दें कि इस फ़ील्ड में 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 |
इवेंट किसे दिखेगा. ज़रूरी नहीं. वैल्यू इस तरह की हो सकती हैं:
|
लिखा जा सकता है |
जवाब
अगर यह सफल होता है, तो यह तरीका रिस्पॉन्स के मुख्य भाग में इवेंट संसाधन दिखाता है.
उदाहरण
ध्यान दें: इस तरीके के लिए दिए गए कोड के उदाहरणों में इसके साथ काम करने वाली सभी प्रोग्रामिंग भाषाएं नहीं दिखाई गई हैं (इसके साथ काम करने वाली भाषाओं की सूची के लिए क्लाइंट लाइब्रेरी वाला पेज देखें).
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
इसे आज़माएं!
इस तरीके को लाइव डेटा पर कॉल करने और जवाब देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.