Events: update

इस कुकी का इस्तेमाल किसी इवेंट को अपडेट करने के लिए किया जाता है. यह तरीका, पैच सिमैंटिक्स के साथ काम नहीं करता. साथ ही, यह हमेशा पूरे इवेंट रिसॉर्स को अपडेट करता है. आंशिक अपडेट करने के लिए, एटैग का इस्तेमाल करके 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 को कॉपी करने की सुविधा के साथ-साथ, conferenceData के createRequest फ़ील्ड का इस्तेमाल करके नई कॉन्फ़्रेंस बनाने की सुविधा भी मिलती है. डिफ़ॉल्ट वैल्यू 0 होती है. मान्य वैल्यू 0 से 1 तक हैं. इसमें 0 और 1 भी शामिल हैं.
eventLabelVersion integer एपीआई क्लाइंट के साथ काम करने वाली इवेंट लेबल सुविधा के वर्शन का नंबर. वर्शन 0 में, इवेंट लेबल की सुविधा काम नहीं करती है. साथ ही, यह रंग मैनेज करने के लिए colorId फ़ील्ड को प्रोसेस करता है. वर्शन 1, इवेंट लेबल के साथ काम करता है. साथ ही, इवेंट के मुख्य हिस्से में मौजूद eventLabelId को प्रोसेस करता है. इस मामले में, colorId फ़ील्ड को अनदेखा कर दिया जाता है. डिफ़ॉल्ट वैल्यू 0 है. मान्य वैल्यू 0 से 1 तक हैं. इसमें 0 और 1 भी शामिल हैं.
maxAttendees integer जवाब में शामिल किए जाने वाले मेहमानों की ज़्यादा से ज़्यादा संख्या. अगर मीटिंग में हिस्सा लेने वाले लोगों की संख्या, तय की गई संख्या से ज़्यादा है, तो सिर्फ़ हिस्सा लेने वाले व्यक्ति की जानकारी मिलती है. ज़रूरी नहीं.
sendNotifications boolean समर्थन नहीं होना या रुकना. कृपया इसके बजाय, sendUpdates का इस्तेमाल करें.

इवेंट के अपडेट के बारे में सूचनाएं भेजनी हैं या नहीं. उदाहरण के लिए, ब्यौरे में बदलाव वगैरह. ध्यान दें कि वैल्यू को false पर सेट करने के बाद भी, कुछ ईमेल भेजे जा सकते हैं. डिफ़ॉल्ट वैल्यू false है.
sendUpdates string ऐसे मेहमान जिन्हें इवेंट के अपडेट के बारे में सूचनाएं मिलनी चाहिए. उदाहरण के लिए, टाइटल में बदलाव वगैरह.

इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "all": सभी मेहमानों को सूचनाएं भेजी जाती हैं.
  • "externalOnly": सूचनाएं सिर्फ़ उन मेहमानों को भेजी जाती हैं जो Google Calendar का इस्तेमाल नहीं करते.
  • "none": कोई सूचना नहीं भेजी जाती है. कैलेंडर माइग्रेशन के टास्क के लिए, Events.import तरीके का इस्तेमाल करें.
supportsAttachments boolean यह जानकारी कि एपीआई क्लाइंट, इवेंट अटैचमेंट के साथ काम करता है या नहीं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह False पर सेट होता है.

अनुमति देना

इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति देना ज़रूरी है:

दायरा
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

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

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

अनुरोध के मुख्य हिस्से में, इवेंट रिसॉर्स की जानकारी दें. इसमें ये प्रॉपर्टी शामिल होनी चाहिए:

प्रॉपर्टी का नाम मान ब्यौरा नोट
ज़रूरी प्रॉपर्टी
end nested object इवेंट के खत्म होने का समय (अलग से उपलब्ध). बार-बार होने वाले इवेंट के लिए, यह पहले इंस्टेंस के खत्म होने का समय होता है.
start nested object इवेंट के शुरू होने का समय (शामिल है). बार-बार होने वाले इवेंट के लिए, यह पहले इंस्टेंस के शुरू होने का समय होता है.
ज़रूरी नहीं है
anyoneCanAddSelf boolean यह तय करता है कि कोई भी व्यक्ति इवेंट में शामिल होने का न्योता खुद को भेज सकता है या नहीं (अब इस्तेमाल नहीं किया जाता). ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह False पर सेट होता है. लिखा जा सकता है
attachments[].fileUrl string अटैचमेंट का यूआरएल लिंक.

Google Drive में मौजूद फ़ाइल अटैचमेंट जोड़ने के लिए, उसी फ़ॉर्मैट का इस्तेमाल करें जो Drive API में Files संसाधन की alternateLink प्रॉपर्टी में इस्तेमाल किया गया है.

अटैचमेंट जोड़ते समय यह फ़ील्ड भरना ज़रूरी है.

 लिखा जा सकता है
attendees[] list इवेंट में शामिल होने वाले लोग. कैलेंडर का इस्तेमाल करने वाले अन्य लोगों के साथ इवेंट शेड्यूल करने के बारे में ज़्यादा जानने के लिए, मेहमानों के साथ इवेंट गाइड देखें. सेवा खातों को, मीटिंग में शामिल होने वाले लोगों की सूची भरने के लिए पूरे डोमेन के लिए अनुमति देने की सुविधा का इस्तेमाल करना होगा. लिखा जा सकता है
attendees[].additionalGuests integer अतिरिक्त मेहमानों की संख्या. ज़रूरी नहीं. डिफ़ॉल्ट वैल्यू 0 होती है. लिखा जा सकता है
attendees[].comment string इसमें शामिल व्यक्ति की टिप्पणी. ज़रूरी नहीं. लिखा जा सकता है
attendees[].displayName string अगर उपलब्ध हो, तो शामिल होने वाले व्यक्ति का नाम. ज़रूरी नहीं. लिखा जा सकता है
attendees[].email string अगर उपलब्ध हो, तो मीटिंग में शामिल होने वाले व्यक्ति का ईमेल पता. किसी व्यक्ति को मेहमान के तौर पर जोड़ने के लिए, यह फ़ील्ड मौजूद होना चाहिए. यह RFC5322 के मुताबिक एक मान्य ईमेल पता होना चाहिए.

किसी व्यक्ति को मेहमान के तौर पर जोड़ते समय यह फ़ील्ड ज़रूरी होता है.

 लिखा जा सकता है
attendees[].optional boolean क्या यह वैकल्पिक तौर पर शामिल होने वाला व्यक्ति है. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह False पर सेट होता है. लिखा जा सकता है
attendees[].resource boolean क्या शामिल होने वाला व्यक्ति कोई संसाधन है. इस विकल्प को सिर्फ़ तब सेट किया जा सकता है, जब किसी मेहमान को पहली बार इवेंट में शामिल किया जाता है. इसके बाद किए गए बदलावों को अनदेखा कर दिया जाता है. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह False पर सेट होता है. लिखा जा सकता है
attendees[].responseStatus string मीटिंग में शामिल होने वाले व्यक्ति के जवाब का स्टेटस. इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "needsAction" - मेहमान ने न्योते का जवाब नहीं दिया है. हमारा सुझाव है कि नए इवेंट के लिए इस विकल्प का इस्तेमाल करें.
  • declined - मेहमान ने बुलावा अस्वीकार कर दिया है.
  • "tentative" - इसका मतलब है कि मेहमान ने न्योते को अभी के लिए स्वीकार किया है.
  • accepted - इसका मतलब है कि मेहमान ने न्योता स्वीकार कर लिया है.
 लिखा जा सकता है
attendeesOmitted boolean इससे पता चलता है कि इवेंट में शामिल होने वाले लोगों को इवेंट के ब्यौरे से हटाया गया है या नहीं. इवेंट वापस पाने के दौरान, ऐसा maxAttendee क्वेरी पैरामीटर की ओर से तय की गई पाबंदी की वजह से हो सकता है. किसी इवेंट को अपडेट करते समय, इसका इस्तेमाल सिर्फ़ हिस्सा लेने वाले व्यक्ति के जवाब को अपडेट करने के लिए किया जा सकता है. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह False पर सेट होता है. लिखा जा सकता है
colorId string इवेंट का रंग. यह एक ऐसा आईडी है जो रंगों की परिभाषा के event सेक्शन में मौजूद किसी एंट्री को दिखाता है. इसके बारे में जानने के लिए, colors एंडपॉइंट देखें. ज़रूरी नहीं. लिखा जा सकता है
conferenceData nested object कॉन्फ़्रेंस से जुड़ी जानकारी, जैसे कि Google Meet कॉन्फ़्रेंस की जानकारी. कॉन्फ़्रेंस की नई जानकारी बनाने के लिए, createRequest फ़ील्ड का इस्तेमाल करें. बदलावों को सेव करने के लिए, इवेंट में बदलाव करने के सभी अनुरोधों के लिए, conferenceDataVersion अनुरोध पैरामीटर को 1 पर सेट करना न भूलें. लिखा जा सकता है
description string इवेंट के बारे में जानकारी. इसमें एचटीएमएल शामिल हो सकता है. ज़रूरी नहीं. लिखा जा सकता है
end.date date अगर यह पूरे दिन का इवेंट है, तो तारीख "yyyy-mm-dd" फ़ॉर्मैट में. लिखा जा सकता है
end.dateTime datetime समय, तारीख और समय की वैल्यू के तौर पर (RFC3339 के मुताबिक फ़ॉर्मैट किया गया). टाइम ज़ोन ऑफ़सेट की जानकारी देना ज़रूरी है. हालांकि, अगर timeZone में टाइम ज़ोन की जानकारी दी गई है, तो इसकी ज़रूरत नहीं है. लिखा जा सकता है
end.timeZone string वह टाइम ज़ोन जिसमें समय बताया गया है. (इसे आईएएनए टाइम ज़ोन डेटाबेस के नाम के तौर पर फ़ॉर्मैट किया गया है. उदाहरण के लिए, "Europe/Zurich".) बार-बार होने वाले इवेंट के लिए, इस फ़ील्ड की ज़रूरत होती है. इससे उस समय क्षेत्र के बारे में पता चलता है जिसमें बार-बार होने वाले इवेंट को बढ़ाया जाता है. सिंगल इवेंट के लिए, यह फ़ील्ड वैकल्पिक होता है. इससे इवेंट के शुरू/खत्म होने के लिए कस्टम टाइम ज़ोन का पता चलता है. लिखा जा सकता है
eventLabelId string इवेंट को असाइन किए गए इवेंट लेबल का आईडी. ज़रूरी नहीं. यह कैलेंडर की labelProperties.eventLabels प्रॉपर्टी में मौजूद किसी एंट्री का आईडी होता है. इसके बारे में जानने के लिए, Calendars.get एंडपॉइंट देखें.

यह प्रॉपर्टी, इंडेक्स पर आधारित colorId प्रॉपर्टी की जगह लेती है. इस प्रॉपर्टी को सेट या बदलने के लिए, आपको insert, import, update, और patch तरीकों के पैरामीटर में eventLabelVersion=1 को तय करना होगा.

इस फ़ील्ड को किसी खाली स्ट्रिंग पर सेट करने या इसे सेट न करने पर, इवेंट से मौजूदा लेबल हट जाएगा.

 लिखा जा सकता है
extendedProperties.private object ये ऐसी प्रॉपर्टी हैं जो इस कैलेंडर पर दिखने वाले इवेंट की कॉपी के लिए निजी होती हैं. लिखा जा सकता है
extendedProperties.shared object ये ऐसी प्रॉपर्टी होती हैं जिन्हें इवेंट की कॉपी के बीच शेयर किया जाता है. ये कॉपी, इवेंट में शामिल अन्य लोगों के कैलेंडर पर दिखती हैं. लिखा जा सकता है
focusTimeProperties nested object फ़ोकस टाइम इवेंट का डेटा. इस एट्रिब्यूट का इस्तेमाल तब किया जाता है, जब eventType एट्रिब्यूट की वैल्यू focusTime हो. लिखा जा सकता है
gadget.display string गैजेट का डिसप्ले मोड. समर्थन नहीं होना या रुकना. इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "icon" - यह गैजेट, कैलेंडर व्यू में इवेंट के टाइटल के बगल में दिखता है.
  • "chip" - यह गैजेट, इवेंट पर क्लिक करने पर दिखता है.
 लिखा जा सकता है
gadget.height integer गैजेट की ऊंचाई, पिक्सल में. ऊंचाई ऐसी पूरी संख्या होनी चाहिए जो शून्य से ज़्यादा हो. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. लिखा जा सकता है
gadget.preferences object प्राथमिकताएं पर क्लिक करें. लिखा जा सकता है
gadget.title string गैजेट का टाइटल. समर्थन नहीं होना या रुकना. लिखा जा सकता है
gadget.type string गैजेट का टाइप. समर्थन नहीं होना या रुकना. लिखा जा सकता है
gadget.width integer पिक्सेल में गैजेट की चौड़ाई. चौड़ाई, 0 से ज़्यादा वाली कोई पूर्णांक संख्या होनी चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. लिखा जा सकता है
guestsCanInviteOthers boolean यह जानकारी कि क्या आयोजक के अलावा अन्य लोग भी इवेंट में शामिल होने के लिए दूसरों को न्योता दे सकते हैं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह True पर सेट होता है. लिखा जा सकता है
guestsCanModify boolean यह जानकारी कि क्या इवेंट शेड्यूल करने वाले व्यक्ति के अलावा, अन्य मेहमान इवेंट में बदलाव कर सकते हैं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह False पर सेट होता है. लिखा जा सकता है
guestsCanSeeOtherGuests boolean यह तय करना कि आयोजक के अलावा, इवेंट में हिस्सा लेने वाले अन्य लोग यह देख सकते हैं या नहीं कि इवेंट में हिस्सा लेने वाले लोग कौन हैं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह True पर सेट होता है. लिखा जा सकता है
location string इवेंट की भौगोलिक जगह, फ़्री-फ़ॉर्म टेक्स्ट के तौर पर. ज़रूरी नहीं. लिखा जा सकता है
originalStartTime.date date अगर यह पूरे दिन का इवेंट है, तो तारीख "yyyy-mm-dd" फ़ॉर्मैट में. लिखा जा सकता है
originalStartTime.dateTime datetime समय, तारीख और समय की वैल्यू के तौर पर (RFC3339 के मुताबिक फ़ॉर्मैट किया गया). टाइम ज़ोन ऑफ़सेट की जानकारी देना ज़रूरी है. हालांकि, अगर timeZone में टाइम ज़ोन की जानकारी दी गई है, तो इसकी ज़रूरत नहीं है. लिखा जा सकता है
originalStartTime.timeZone string वह टाइम ज़ोन जिसमें समय बताया गया है. (इसे आईएएनए टाइम ज़ोन डेटाबेस के नाम के तौर पर फ़ॉर्मैट किया गया है. उदाहरण के लिए, "Europe/Zurich".) बार-बार होने वाले इवेंट के लिए, इस फ़ील्ड की ज़रूरत होती है. इससे उस समय क्षेत्र के बारे में पता चलता है जिसमें बार-बार होने वाले इवेंट को बढ़ाया जाता है. सिंगल इवेंट के लिए, यह फ़ील्ड वैकल्पिक होता है. इससे इवेंट के शुरू/खत्म होने के लिए कस्टम टाइम ज़ोन का पता चलता है. लिखा जा सकता है
outOfOfficeProperties nested object 'अभी मैं छुट्टी पर हूं' इवेंट का डेटा. इस एट्रिब्यूट का इस्तेमाल तब किया जाता है, जब eventType एट्रिब्यूट की वैल्यू outOfOffice हो. लिखा जा सकता है
recurrence[] list बार-बार होने वाले इवेंट के लिए, RRULE, EXRULE, RDATE, और EXDATE लाइनों की सूची. यह RFC5545 में बताई गई है. ध्यान दें कि इस फ़ील्ड में DTSTART और DTEND लाइनें इस्तेमाल करने की अनुमति नहीं है. इवेंट के शुरू और खत्म होने का समय, start और end फ़ील्ड में दिया जाता है. इस फ़ील्ड को, किसी खास इवेंट या बार-बार होने वाले इवेंट के इंस्टेंस के लिए शामिल नहीं किया जाता. लिखा जा सकता है
reminders.overrides[] list अगर इवेंट में डिफ़ॉल्ट रिमाइंडर का इस्तेमाल नहीं किया जाता है, तो इससे इवेंट के हिसाब से रिमाइंडर की सूची दिखती है. अगर रिमाइंडर सेट नहीं किए गए हैं, तो इससे पता चलता है कि इस इवेंट के लिए कोई रिमाइंडर सेट नहीं किया गया है. छुट्टी के रिमाइंडर को ज़्यादा से ज़्यादा पांच बार अनदेखा किया जा सकता है. लिखा जा सकता है
reminders.overrides[].method string इस रिमाइंडर के लिए इस्तेमाल किया गया तरीका. इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "email" - रिमाइंडर ईमेल से भेजे जाते हैं.
  • "popup" - रिमाइंडर, यूज़र इंटरफ़ेस वाले पॉप-अप के ज़रिए भेजे जाते हैं.

रिमाइंडर जोड़ने के लिए ज़रूरी है.

 लिखा जा सकता है
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 वह टाइम ज़ोन जिसमें समय बताया गया है. (इसे आईएएनए टाइम ज़ोन डेटाबेस के नाम के तौर पर फ़ॉर्मैट किया गया है. उदाहरण के लिए, "Europe/Zurich".) बार-बार होने वाले इवेंट के लिए, इस फ़ील्ड की ज़रूरत होती है. इससे उस समय क्षेत्र के बारे में पता चलता है जिसमें बार-बार होने वाले इवेंट को बढ़ाया जाता है. सिंगल इवेंट के लिए, यह फ़ील्ड वैकल्पिक होता है. इससे इवेंट के शुरू/खत्म होने के लिए कस्टम टाइम ज़ोन का पता चलता है. लिखा जा सकता है
status string इवेंट की स्थिति. ज़रूरी नहीं. इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "confirmed" - इवेंट की पुष्टि हो गई है. यह डिफ़ॉल्ट स्थिति है.
  • "tentative" - इवेंट की पुष्टि अस्थायी तौर पर की गई है.
  • "cancelled" - इवेंट रद्द कर दिया गया है (मिटा दिया गया है). list तरीके से, रद्द किए गए इवेंट सिर्फ़ इंक्रीमेंटल सिंक (जब syncToken या updatedMin तय किए गए हों) पर दिखते हैं. इसके अलावा, अगर showDeleted फ़्लैग को true पर सेट किया गया हो, तब भी रद्द किए गए इवेंट दिखते हैं. get तरीके से हमेशा ये वैल्यू मिलती हैं.

    'रद्द किया गया' स्टेटस, इवेंट टाइप के हिसाब से दो अलग-अलग स्थितियों को दिखाता है:

    1. बार-बार होने वाले किसी ऐसे इवेंट के रद्द किए गए अपवादों से पता चलता है कि इस इंस्टेंस को अब उपयोगकर्ता को नहीं दिखाया जाना चाहिए. क्लाइंट को इन इवेंट को, बार-बार होने वाले पैरंट इवेंट की पूरी अवधि के लिए सेव करना चाहिए.

      रद्द किए गए अपवादों के लिए, सिर्फ़ id, recurringEventId, और originalStartTime फ़ील्ड की वैल्यू भरी जाती हैं. ऐसा हो सकता है कि अन्य फ़ील्ड खाली हों.

    2. रद्द किए गए अन्य सभी इवेंट, मिटाए गए इवेंट होते हैं. क्लाइंट को अपनी लोकल सिंक की गई कॉपी हटा देनी चाहिए. रद्द किए गए ऐसे इवेंट आखिर में दिखना बंद हो जाएंगे. इसलिए, यह न सोचें कि ये हमेशा उपलब्ध रहेंगे.

      मिटाए गए इवेंट के लिए, सिर्फ़ id फ़ील्ड में वैल्यू मौजूद होती है.

    आयोजक के कैलेंडर में, रद्द किए गए इवेंट की जानकारी (खास जानकारी, जगह वगैरह) दिखती रहती है, ताकि उन्हें वापस लाया जा सके. इसी तरह, जिन इवेंट के लिए उपयोगकर्ता को न्योता भेजा गया था और जिन्हें उसने मैन्युअल तरीके से हटाया था उनकी जानकारी भी मिलती रहेगी. हालांकि, showDeleted को 'गलत है' पर सेट करके, इंक्रीमेंटल सिंक के अनुरोध करने पर यह जानकारी नहीं मिलेगी.

    अगर किसी इवेंट का आयोजक बदल जाता है (उदाहरण के लिए, move ऑपरेशन के ज़रिए) और मूल आयोजक, शामिल होने वाले लोगों की सूची में नहीं है, तो इवेंट रद्द हो जाएगा. इसमें सिर्फ़ id फ़ील्ड में जानकारी मौजूद होगी.

लिखा जा सकता है
summary string इवेंट का शीर्षक. लिखा जा सकता है
transparency string इससे पता चलता है कि इवेंट, कैलेंडर में समय ब्लॉक करता है या नहीं. ज़रूरी नहीं. इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "opaque" - डिफ़ॉल्ट वैल्यू. इवेंट, कैलेंडर में समय को ब्लॉक करता है. यह Calendar के यूज़र इंटरफ़ेस (यूआई) में, मुझे इस तरह दिखाएं को व्यस्त पर सेट करने के बराबर है.
  • "transparent" - इस इवेंट से कैलेंडर में कोई समय ब्लॉक नहीं होता. यह Calendar के यूज़र इंटरफ़ेस (यूआई) में, मुझे इस तरह दिखाएं को उपलब्ध है पर सेट करने के बराबर है.
 लिखा जा सकता है
visibility string इवेंट किसको दिखे. ज़रूरी नहीं. इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "default" - इससे कैलेंडर पर मौजूद इवेंट के लिए, डिफ़ॉल्ट रूप से दिखने की सेटिंग का इस्तेमाल होता है. यह डिफ़ॉल्ट मान है.
  • "public" - इवेंट सार्वजनिक है और इवेंट की जानकारी, कैलेंडर देखने वाले सभी लोगों को दिखती है.
  • "private" - इवेंट को निजी के तौर पर मार्क किया गया है. इसमें शामिल लोग ही इवेंट की जानकारी देख सकते हैं.
  • "confidential" - इवेंट को निजी के तौर पर सेट किया गया है. यह वैल्यू, पुराने सिस्टम के साथ काम करने की सुविधा के लिए दी गई है.
 लिखा जा सकता है
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 ऑफ़िस का वह नाम जो Calendar के वेब और मोबाइल क्लाइंट पर दिखता है. हमारा सुझाव है कि आप संगठन के संसाधन डेटाबेस में, बिल्डिंग का नाम डालें. लिखा जा सकता है
workingLocationProperties.type string काम करने की जगह का टाइप. इन वैल्यू का इस्तेमाल किया जा सकता है:
  • "homeOffice" - उपयोगकर्ता घर से काम कर रहा है.
  • "officeLocation" - उपयोगकर्ता ऑफ़िस से काम कर रहा है.
  • "customLocation" - उपयोगकर्ता किसी कस्टम जगह से काम कर रहा है.
कोई भी जानकारी, तय किए गए नाम के सब-फ़ील्ड में दी जाती है. हालांकि, अगर यह फ़ील्ड खाली है, तो यह मौजूद नहीं हो सकता. अन्य फ़ील्ड को अनदेखा कर दिया जाता है.

काम करने की जगह की प्रॉपर्टी जोड़ते समय यह ज़रूरी है.

 लिखा जा सकता है

जवाब

अनुरोध पूरा होने पर, यह तरीका जवाब के मुख्य हिस्से में Events संसाधन दिखाता है.

इसे आज़माएं!

लाइव डेटा पर इस तरीके को कॉल करने और जवाब देखने के लिए, यहां दिए गए APIs explorer का इस्तेमाल करें.