Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 संसाधन दिखता है.

इसे आज़माएं!

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