Events: insert

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

इवेंट बनाया जाता है. इसे अभी आज़माएं.

अनुरोध

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

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

पैरामीटर

पैरामीटर का नाम	मान	ब्यौरा
पाथ पैरामीटर
calendarId	string	कैलेंडर का आइडेंटिफ़ायर. कैलेंडर आईडी वापस पाने के लिए, calendarList.list तरीके को कॉल करें. अगर आपको फ़िलहाल लॉग इन किए गए उपयोगकर्ता के प्राइमरी कैलेंडर को ऐक्सेस करना है, तो "primary" कीवर्ड का इस्तेमाल करें.
वैकल्पिक क्वेरी पैरामीटर
conferenceDataVersion	integer	एपीआई क्लाइंट के साथ काम करने वाले कॉन्फ़्रेंस डेटा का वर्शन नंबर. वर्शन 0 में, कॉन्फ़्रेंस डेटा के साथ काम करने की सुविधा नहीं होती है. साथ ही, यह इवेंट के मुख्य हिस्से में मौजूद कॉन्फ़्रेंस डेटा को अनदेखा करता है. वर्शन 1 में, ConferenceData को कॉपी करने की सुविधा मिलती है. साथ ही, इसमें conferenceData के createRequest फ़ील्ड का इस्तेमाल करके नई कॉन्फ़्रेंस बनाने की सुविधा भी मिलती है. डिफ़ॉल्ट वैल्यू 0 होती है. मान्य वैल्यू 0 से 1 तक हैं. इसमें 0 और 1 भी शामिल हैं.
maxAttendees	integer	जवाब में शामिल किए जाने वाले मेहमानों की ज़्यादा से ज़्यादा संख्या. अगर मीटिंग में हिस्सा लेने वाले लोगों की संख्या, तय की गई संख्या से ज़्यादा है, तो सिर्फ़ हिस्सा लेने वाले व्यक्ति की जानकारी मिलती है. ज़रूरी नहीं.
sendNotifications	boolean	समर्थन नहीं होना या रुकना. कृपया इसके बजाय, sendUpdates का इस्तेमाल करें. इससे यह तय किया जाता है कि नए इवेंट के बनने की सूचनाएं भेजी जाएं या नहीं. ध्यान दें कि वैल्यू को false पर सेट करने के बाद भी, कुछ ईमेल भेजे जा सकते हैं. डिफ़ॉल्ट वैल्यू false है.
sendUpdates	string	यह तय करता है कि नया इवेंट बनाए जाने पर सूचनाएं भेजी जाएं या नहीं. ध्यान दें कि कुछ ईमेल अब भी भेजे जा सकते हैं. डिफ़ॉल्ट वैल्यू false है. इन वैल्यू का इस्तेमाल किया जा सकता है: "all": सभी मेहमानों को सूचनाएं भेजी जाती हैं. "externalOnly": सूचनाएं सिर्फ़ उन मेहमानों को भेजी जाती हैं जो Google Calendar का इस्तेमाल नहीं करते. "none": कोई सूचना नहीं भेजी जाती. चेतावनी: 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" - इसका मतलब है कि मेहमान ने न्योता स्वीकार कर लिया है. चेतावनी: declined, tentative या accepted वैल्यू का इस्तेमाल करके इवेंट जोड़ने पर, "मेरे कैलेंडर में न्योते जोड़ें" सेटिंग को "अगर मैंने न्योते के ईमेल का जवाब दिया हो" या "अगर न्योता भेजने वाला व्यक्ति मेरी पहचान का हो" पर सेट करने वाले लोगों के जवाब needsAction पर रीसेट हो सकते हैं. साथ ही, उन्हें अपने कैलेंडर में कोई इवेंट नहीं दिखेगा. ऐसा तब तक होगा, जब तक वे इवेंट के न्योते वाले ईमेल में अपना जवाब नहीं बदल देते. इसके अलावा, अगर इवेंट में 200 से ज़्यादा मेहमानों को न्योता भेजा जाता है, तो जवाब की स्थिति मेहमानों को नहीं दिखती.	लिखा जा सकता है
birthdayProperties	nested object	जन्मदिन या खास इवेंट का डेटा. अगर eventType "birthday" है, तो इसका इस्तेमाल किया जाता है. इम्यूटेबल.	लिखा जा सकता है
birthdayProperties.type	string	बर्थडे या खास इवेंट का टाइप. इन वैल्यू का इस्तेमाल किया जा सकता है: "anniversary" - जन्मदिन के अलावा, कोई और सालगिरह. इसमें हमेशा contact होता है. "birthday" - जन्मदिन का इवेंट. यह डिफ़ॉल्ट मान है. "custom" - यह एक खास तारीख होती है. इसका लेबल customTypeName फ़ील्ड में दिया जाता है. इसमें हमेशा contact होता है. "other" - यह एक खास तारीख है, जो अन्य कैटगरी में नहीं आती है. साथ ही, इसका कोई कस्टम लेबल नहीं है. इसमें हमेशा contact होता है. "self" - कैलेंडर के मालिक का जन्मदिन. इसमें contact नहीं हो सकता. Calendar API, सिर्फ़ "birthday" टाइप के इवेंट बनाने की सुविधा देता है. इवेंट बनाने के बाद, इसका टाइप नहीं बदला जा सकता.	लिखा जा सकता है
colorId	string	इवेंट का रंग. यह एक ऐसा आईडी है जो रंग की परिभाषा के event सेक्शन में मौजूद किसी एंट्री को दिखाता है. इसके बारे में जानने के लिए, colors एंडपॉइंट देखें. ज़रूरी नहीं.	लिखा जा सकता है
conferenceData	nested object	कॉन्फ़्रेंस से जुड़ी जानकारी, जैसे कि Google Meet कॉन्फ़्रेंस की जानकारी. कॉन्फ़्रेंस की नई जानकारी बनाने के लिए, createRequest फ़ील्ड का इस्तेमाल करें. बदलावों को सेव करने के लिए, इवेंट में बदलाव करने के सभी अनुरोधों के लिए, conferenceDataVersion अनुरोध पैरामीटर को 1 पर सेट करना न भूलें. चेतावनी: अलग-अलग इवेंट के लिए, Google Meet कॉन्फ़्रेंस के डेटा का दोबारा इस्तेमाल करने से, ऐक्सेस से जुड़ी समस्याएं हो सकती हैं. साथ ही, मीटिंग की जानकारी उन लोगों को दिख सकती है जिन्हें यह जानकारी नहीं दिखनी चाहिए. मीटिंग की निजता को सुरक्षित रखने के लिए, createRequest फ़ील्ड का इस्तेमाल करके हर इवेंट के लिए एक यूनीक कॉन्फ़्रेंस जनरेट करें.	लिखा जा सकता है
description	string	इवेंट के बारे में जानकारी. इसमें एचटीएमएल शामिल हो सकता है. ज़रूरी नहीं.	लिखा जा सकता है
end.date	date	अगर यह पूरे दिन का इवेंट है, तो तारीख "yyyy-mm-dd" फ़ॉर्मैट में.	लिखा जा सकता है
end.dateTime	datetime	समय, तारीख और समय की वैल्यू के तौर पर (RFC3339 के मुताबिक फ़ॉर्मैट किया गया). timeZone में समय क्षेत्र की जानकारी साफ़ तौर पर न दिए जाने पर, टाइम ज़ोन ऑफ़सेट की जानकारी देना ज़रूरी है.	लिखा जा सकता है
end.timeZone	string	वह टाइम ज़ोन जिसमें समय बताया गया है. (इसे IANA Time Zone Database के नाम के तौर पर फ़ॉर्मैट किया गया है. उदाहरण के लिए, "Europe/Zurich".) बार-बार होने वाले इवेंट के लिए, इस फ़ील्ड की ज़रूरत होती है. इससे उस टाइम ज़ोन के बारे में पता चलता है जिसमें इवेंट को दोहराया जाता है. किसी खास इवेंट के लिए, यह फ़ील्ड भरना ज़रूरी नहीं है. इससे इवेंट के शुरू/खत्म होने के लिए कस्टम टाइम ज़ोन का पता चलता है.	लिखा जा सकता है
eventType	string	इवेंट का टाइप. इवेंट बनाने के बाद, इसमें बदलाव नहीं किया जा सकता. इन वैल्यू का इस्तेमाल किया जा सकता है: "birthday" - यह पूरे दिन चलने वाला एक खास इवेंट है, जो हर साल होता है. "default" - सामान्य इवेंट या इसके बारे में ज़्यादा जानकारी नहीं दी गई है. "focusTime" - काम पर फ़ोकस करने के लिए बनाया गया इवेंट. "fromGmail" - Gmail से मिला कोई इवेंट. इस तरह का इवेंट नहीं बनाया जा सकता. "outOfOffice" - यह 'अभी मैं छुट्टी पर हूं' इवेंट होता है. "workingLocation" - काम करने की जगह की जानकारी देने वाला इवेंट.	लिखा जा सकता है
extendedProperties.private	object	ऐसी प्रॉपर्टी जो इस कैलेंडर पर दिखने वाले इवेंट की कॉपी के लिए निजी होती हैं.	लिखा जा सकता है
extendedProperties.shared	object	ये ऐसी प्रॉपर्टी होती हैं जिन्हें इवेंट में शामिल अन्य लोगों के कैलेंडर पर, इवेंट की कॉपी के बीच शेयर किया जाता है.	लिखा जा सकता है
focusTimeProperties	nested object	फ़ोकस टाइम इवेंट का डेटा. अगर eventType focusTime है, तो इसका इस्तेमाल किया जाता है.	लिखा जा सकता है
gadget.display	string	गैजेट का डिसप्ले मोड. समर्थन नहीं होना या रुकना. इन वैल्यू का इस्तेमाल किया जा सकता है: "icon" - यह गैजेट, कैलेंडर व्यू में इवेंट के टाइटल के बगल में दिखता है. "chip" - यह गैजेट, इवेंट पर क्लिक करने पर दिखता है.	लिखा जा सकता है
gadget.height	integer	पिक्सल में गैजेट की ऊंचाई. ऊंचाई ऐसी पूरी संख्या होनी चाहिए जो शून्य से ज़्यादा हो. ज़रूरी नहीं. समर्थन नहीं होना या रुकना.	लिखा जा सकता है
gadget.iconLink	string	गैजेट के आइकॉन का यूआरएल. यूआरएल स्कीम, एचटीटीपीएस होनी चाहिए. समर्थन नहीं होना या रुकना.	लिखा जा सकता है
gadget.link	string	गैजेट का यूआरएल. यूआरएल स्कीम, एचटीटीपीएस होनी चाहिए. समर्थन नहीं होना या रुकना.	लिखा जा सकता है
gadget.preferences	object	प्राथमिकताएं पर क्लिक करें.	लिखा जा सकता है
gadget.title	string	गैजेट का टाइटल. समर्थन नहीं होना या रुकना.	लिखा जा सकता है
gadget.type	string	गैजेट का टाइप. समर्थन नहीं होना या रुकना.	लिखा जा सकता है
gadget.width	integer	पिक्सेल में गैजेट की चौड़ाई. चौड़ाई, 0 से ज़्यादा वाली कोई पूर्णांक संख्या होनी चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना.	लिखा जा सकता है
guestsCanInviteOthers	boolean	क्या आयोजक के अलावा अन्य लोग भी इवेंट में शामिल होने के लिए न्योता भेज सकते हैं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह True पर सेट होता है.	लिखा जा सकता है
guestsCanModify	boolean	यह जानकारी कि क्या इवेंट शेड्यूल करने वाले व्यक्ति के अलावा, अन्य लोग भी इवेंट में बदलाव कर सकते हैं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह False पर सेट होता है.	लिखा जा सकता है
guestsCanSeeOtherGuests	boolean	यह तय करना कि आयोजक के अलावा, इवेंट में हिस्सा लेने वाले अन्य लोग यह देख सकते हैं या नहीं कि इवेंट में हिस्सा लेने वाले लोग कौन हैं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह True पर सेट होता है.	लिखा जा सकता है
id	string	इवेंट का अपारदर्शी आइडेंटिफ़ायर. एक बार होने वाले या बार-बार होने वाले नए इवेंट बनाते समय, उनके आईडी तय किए जा सकते हैं. दिए गए आईडी इन नियमों के मुताबिक होने चाहिए: आईडी में इस्तेमाल किए जा सकने वाले वर्ण, base32hex एन्कोडिंग में इस्तेमाल किए जाते हैं.जैसे, अंग्रेज़ी के छोटे अक्षर a से v और अंक 0 से 9. इसके बारे में ज़्यादा जानने के लिए, RFC2938 में सेक्शन 3.1.2 देखें आईडी की लंबाई 5 से 1,024 वर्णों के बीच होनी चाहिए हर कैलेंडर के लिए आईडी यूनीक होना चाहिए सिस्टम दुनिया भर में फैला हुआ है. इसलिए, हम इस बात की गारंटी नहीं दे सकते कि इवेंट बनाते समय आईडी के टकराव का पता चल जाएगा. हमारा सुझाव है कि टकराव के जोखिम को कम करने के लिए, RFC4122 में बताए गए यूयूआईडी एल्गोरिदम जैसे किसी भरोसेमंद यूयूआईडी एल्गोरिदम का इस्तेमाल करें. अगर आपने कोई आईडी नहीं दिया है, तो सर्वर इसे अपने-आप जनरेट कर देगा. ध्यान दें कि icalUID और id एक जैसे नहीं हैं. इवेंट बनाते समय, इनमें से सिर्फ़ एक को सबमिट किया जाना चाहिए. इनके सिमैंटिक में एक अंतर यह है कि बार-बार होने वाले इवेंट में, एक इवेंट के सभी इंस्टेंस के लिए अलग-अलग id होते हैं, जबकि वे सभी एक ही icalUID शेयर करते हैं.	लिखा जा सकता है
location	string	इवेंट की भौगोलिक जगह के बारे में बिना स्ट्रक्चर वाला टेक्स्ट. ज़रूरी नहीं.	लिखा जा सकता है
originalStartTime.date	date	अगर यह पूरे दिन का इवेंट है, तो तारीख "yyyy-mm-dd" फ़ॉर्मैट में.	लिखा जा सकता है
originalStartTime.dateTime	datetime	समय, तारीख और समय की वैल्यू के तौर पर (RFC3339 के मुताबिक फ़ॉर्मैट किया गया). timeZone में समय क्षेत्र की जानकारी साफ़ तौर पर न दिए जाने पर, टाइम ज़ोन ऑफ़सेट की जानकारी देना ज़रूरी है.	लिखा जा सकता है
originalStartTime.timeZone	string	वह टाइम ज़ोन जिसमें समय बताया गया है. (इसे IANA Time Zone Database के नाम के तौर पर फ़ॉर्मैट किया गया है. उदाहरण के लिए, "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	वह टाइम ज़ोन जिसमें समय बताया गया है. (इसे IANA Time Zone Database के नाम के तौर पर फ़ॉर्मैट किया गया है. उदाहरण के लिए, "Europe/Zurich".) बार-बार होने वाले इवेंट के लिए, इस फ़ील्ड की ज़रूरत होती है. इससे उस टाइम ज़ोन के बारे में पता चलता है जिसमें इवेंट को दोहराया जाता है. किसी खास इवेंट के लिए, यह फ़ील्ड भरना ज़रूरी नहीं है. इससे इवेंट के शुरू/खत्म होने के लिए कस्टम टाइम ज़ोन का पता चलता है.	लिखा जा सकता है
status	string	इवेंट की स्थिति. ज़रूरी नहीं. इन वैल्यू का इस्तेमाल किया जा सकता है: "confirmed" - इवेंट की पुष्टि हो गई है. यह डिफ़ॉल्ट स्टेटस है. "tentative" - इवेंट की पुष्टि अस्थाई तौर पर की गई है. "cancelled" - इवेंट रद्द कर दिया गया है (मिटा दिया गया है). list तरीके से, रद्द किए गए इवेंट सिर्फ़ इंक्रीमेंटल सिंक (जब syncToken या updatedMin तय किए गए हों) पर दिखते हैं. इसके अलावा, अगर showDeleted फ़्लैग को true पर सेट किया गया हो, तब भी रद्द किए गए इवेंट दिखते हैं. get तरीके से हमेशा ये वैल्यू मिलती हैं. 'रद्द किया गया' स्टेटस, इवेंट टाइप के हिसाब से दो अलग-अलग स्थितियों को दिखाता है: बार-बार होने वाले किसी ऐसे इवेंट के रद्द किए गए अपवादों से पता चलता है कि इस इंस्टेंस को अब उपयोगकर्ता को नहीं दिखाया जाना चाहिए. क्लाइंट को इन इवेंट को, बार-बार होने वाले पैरंट इवेंट की पूरी अवधि के लिए सेव करना चाहिए. रद्द किए गए अपवादों के लिए, सिर्फ़ id, recurringEventId, और originalStartTime फ़ील्ड की वैल्यू भरी जाती हैं. ऐसा हो सकता है कि अन्य फ़ील्ड खाली हों. रद्द किए गए अन्य सभी इवेंट, मिटाए गए इवेंट होते हैं. क्लाइंट को अपनी लोकल सिंक की गई कॉपी हटा देनी चाहिए. रद्द किए गए ऐसे इवेंट आखिर में दिखना बंद हो जाएंगे. इसलिए, यह न सोचें कि ये हमेशा उपलब्ध रहेंगे. मिटाए गए इवेंट में सिर्फ़ 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 संसाधन दिखता है.

इसे आज़माएं!

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