इस पेज का अनुवाद Cloud Translation API से किया गया है.

Events: insert

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

अनुरोध

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

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

पैरामीटर

पैरामीटर का नाम	मान	ब्यौरा
पाथ पैरामीटर
`calendarId`	`string`	कैलेंडर आइडेंटिफ़ायर. कैलेंडर आईडी वापस पाने के लिए, calendarList.list तरीके को कॉल करें. अगर आपको उस उपयोगकर्ता का मुख्य कैलेंडर ऐक्सेस करना है जिसने फ़िलहाल लॉग इन किया हुआ है, तो "`primary`" का इस्तेमाल करें कीवर्ड.
वैकल्पिक क्वेरी पैरामीटर
`conferenceDataVersion`	`integer`	एपीआई क्लाइंट पर काम करने वाले कॉन्फ़्रेंस डेटा का वर्शन नंबर. वर्शन 0 के मुताबिक, कोई कॉन्फ़्रेंस डेटा उपलब्ध नहीं है और इवेंट के मुख्य हिस्से में कॉन्फ़्रेंस के डेटा को अनदेखा किया गया है. वर्शन 1 में ConferenceData को कॉपी करने और नई कॉन्फ़्रेंस बनाने की सुविधा चालू की गई है. इसके लिए, कॉन्फ़्रेंस डेटा के createRequest फ़ील्ड का इस्तेमाल किया जा सकता है. डिफ़ॉल्ट वैल्यू 0 होती है. स्वीकार की जाने वाली वैल्यू `0` से `1` तक हैं. इसमें ये वैल्यू भी शामिल हैं.
`maxAttendees`	`integer`	जवाब में ज़्यादा से ज़्यादा कितने मेहमानों को शामिल करना है. अगर मीटिंग में तय संख्या से ज़्यादा मेहमान मौजूद हैं, तो मीटिंग में शामिल व्यक्ति को ही लौटाया जाता है. ज़रूरी नहीं.
`sendNotifications`	`boolean`	समर्थन नहीं होना या रुकना. इसके बजाय, कृपया sendUpdates का इस्तेमाल करें. नया इवेंट बनाने के बारे में सूचनाएं भेजें या नहीं. ध्यान दें कि वैल्यू को `false` पर सेट करने के बाद भी कुछ ईमेल भेजे जा सकते हैं. डिफ़ॉल्ट वैल्यू `false` है.
`sendUpdates`	`string`	चुनें कि नया इवेंट बनाने के बारे में सूचनाएं भेजनी हैं या नहीं. ध्यान दें कि कुछ ईमेल अब भी भेजे जा सकते हैं. डिफ़ॉल्ट वैल्यू `false` है. ये वैल्यू स्वीकार की जाती हैं: "`all`": सूचनाएं सभी मेहमानों को भेजी जाती हैं. "`externalOnly`": Google Calendar का इस्तेमाल नहीं करने वाले लोगों को ही सूचनाएं भेजी जाती हैं. "`none`": कोई सूचना नहीं भेजी गई है. चेतावनी: `none` वैल्यू का इस्तेमाल करने पर, काफ़ी बुरा असर पड़ सकता है. जैसे, बाहरी कैलेंडर के साथ इवेंट सिंक न होना या कुछ उपयोगकर्ताओं के लिए इवेंट का पूरी तरह से हट जाना. कैलेंडर माइग्रेशन के टास्क के लिए, events.import तरीके का इस्तेमाल करें.
`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 में, `Files` संसाधन की `alternateLink` प्रॉपर्टी में किया गया है. अटैचमेंट जोड़ते समय ज़रूरी है.	लिखा जा सकता है
`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`	मेहमान के जवाब की स्थिति. संभावित वैल्यू ये हैं: "`needsAction`" - उपस्थितजन ने आमंत्रण का उत्तर नहीं दिया (नए इवेंट के लिए सुझाए गए). "`declined`" - मेहमान ने न्योता अस्वीकार कर दिया है. "`tentative`" - मेहमान ने अस्थायी रूप से न्योता स्वीकार कर लिया है. "`accepted`" - मेहमान ने न्योता स्वीकार कर लिया है. चेतावनी: अगर आपने `declined`, `tentative` या `accepted` वैल्यू का इस्तेमाल करके कोई इवेंट जोड़ा है, तो जिन मेहमानों के पास "मेरे कैलेंडर में न्योते जोड़ें" विकल्प होगा सेटिंग "जब मैं ईमेल में न्योते का जवाब दूं" पर सेट हो या "अगर न्योता भेजने वाला व्यक्ति पहचान का हो" उनका जवाब `needsAction` पर रीसेट हो सकता है और उन्हें अपने कैलेंडर में कोई इवेंट तब तक नहीं दिखेगा, जब तक वे इवेंट के न्योते के ईमेल में अपना जवाब नहीं बदल देते. अगर इवेंट में 200 से ज़्यादा मेहमानों को शामिल होने का न्योता दिया जाता है, तो मेहमानों को जवाब का स्टेटस नहीं दिखाया जाता.	लिखा जा सकता है
`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 टाइम ज़ोन डेटाबेस नाम के रूप में फ़ॉर्मैट किया गया, जैसे "यूरोप/ज़ूरिख़".) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी है. साथ ही, यह उस टाइम ज़ोन के बारे में बताता है जिसमें बार-बार होने वाले इवेंट को बड़ा किया जाता है. किसी एक इवेंट के लिए यह फ़ील्ड ज़रूरी नहीं है. साथ ही, इवेंट के शुरू/खत्म होने के लिए कस्टम टाइम ज़ोन दिखाता है.	लिखा जा सकता है
`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`	पिक्सल में गैजेट की ऊंचाई. ऊंचाई 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`	क्या आयोजक के अलावा अन्य उपस्थित लोग यह देख सकते हैं कि इवेंट के उपस्थित लोग कौन हैं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, 'सही' होता है.	लिखा जा सकता है
`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 टाइम ज़ोन डेटाबेस नाम के रूप में फ़ॉर्मैट किया गया, जैसे "यूरोप/ज़ूरिख़".) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी है. साथ ही, यह उस टाइम ज़ोन के बारे में बताता है जिसमें बार-बार होने वाले इवेंट को बड़ा किया जाता है. किसी एक इवेंट के लिए यह फ़ील्ड ज़रूरी नहीं है. साथ ही, इवेंट के शुरू/खत्म होने के लिए कस्टम टाइम ज़ोन दिखाता है.	लिखा जा सकता है
`outOfOfficeProperties`	`nested object`	'अभी मैं छुट्टी पर हूं' इवेंट का डेटा. अगर `eventType`, `outOfOffice` है, तो इस्तेमाल किया जाता है.	लिखा जा सकता है
`recurrence[]`	`list`	बार-बार होने वाले इवेंट के लिए, RRule, EX बिना, 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 टाइम ज़ोन डेटाबेस नाम के रूप में फ़ॉर्मैट किया गया, जैसे "यूरोप/ज़ूरिख़".) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी है. साथ ही, यह उस टाइम ज़ोन के बारे में बताता है जिसमें बार-बार होने वाले इवेंट को बड़ा किया जाता है. किसी एक इवेंट के लिए यह फ़ील्ड ज़रूरी नहीं है. साथ ही, इवेंट के शुरू/खत्म होने के लिए कस्टम टाइम ज़ोन दिखाता है.	लिखा जा सकता है
`status`	`string`	इवेंट की स्थिति. ज़रूरी नहीं. संभावित वैल्यू ये हैं: "`confirmed`" - इवेंट की पुष्टि हो गई है. यह डिफ़ॉल्ट स्थिति है. "`tentative`" - इवेंट की पक्के तौर पर पुष्टि हो गई है. "`cancelled`" - इवेंट रद्द कर दिया गया है (मिटाया गया). list तरीके से रद्द किए गए इवेंट सिर्फ़ इंक्रीमेंटल सिंक होने पर दिखते हैं (जब `syncToken` या `updatedMin` के बारे में बताया गया हो) या अगर `showDeleted` फ़्लैग `true` पर सेट हो. get मेथड से ये नतीजे हमेशा दिखते हैं. रद्द की गई स्थिति, इवेंट टाइप के आधार पर दो अलग-अलग स्थितियों को दिखाती है: रद्द नहीं किए गए बार-बार होने वाले इवेंट के रद्द किए गए अपवाद का मतलब है कि यह इंस्टेंस अब उपयोगकर्ता को नहीं दिखाया जाना चाहिए. क्लाइंट को ये इवेंट, पैरंट बार-बार होने वाले इवेंट की अवधि तक सेव रखने चाहिए. रद्द किए गए अपवादों के लिए, सिर्फ़ `id`, `recurringEventId`, और `originalStartTime` फ़ील्ड की वैल्यू अपने-आप भरने की गारंटी दी जाती है. दूसरे फ़ील्ड खाली हो सकते हैं. रद्द किए गए अन्य सभी इवेंट, मिटाए गए इवेंट दिखाते हैं. क्लाइंट को अपनी डिवाइस में सिंक की गई कॉपी हटानी चाहिए. ऐसे रद्द किए गए इवेंट समय के साथ गायब हो जाते हैं. इसलिए, इनके उपलब्ध रहने पर भरोसा न करें. मिटाए गए इवेंट के लिए, सिर्फ़ `id` फ़ील्ड में जानकारी अपने-आप भरने की गारंटी होती है. आयोजक के कैलेंडर पर, रद्द किए गए इवेंट, इवेंट की जानकारी दिखाते रहते हैं. जैसे, खास जानकारी, जगह की जानकारी वगैरह. ऐसा करने पर, उन्हें वापस लाया जा सकता है (मिटाया गया आइटम वापस लाया जा सकता है). इसी तरह, जिन इवेंट के लिए उपयोगकर्ता को न्योता दिया गया था और जिन्हें मैन्युअल तरीके से हटाया गया था उनसे जुड़ी जानकारी मिलती रहती है. हालांकि, `showDeleted` के साथ इंक्रीमेंटल सिंक अनुरोधों को 'गलत' पर सेट किया गया होगा, तो इससे यह जानकारी नहीं मिलेगी. अगर कोई इवेंट अपना आयोजक बदल जाता है (उदाहरण के लिए, ले जाएं कार्रवाई के ज़रिए) और मूल आयोजक मेहमानों की सूची में नहीं है, तो वह रद्द किया गया इवेंट छोड़ देगा, जहां सिर्फ़ `id` फ़ील्ड में जानकारी अपने-आप भर जाएगी.	लिखा जा सकता है
`summary`	`string`	इवेंट का शीर्षक.	लिखा जा सकता है
`transparency`	`string`	इवेंट, कैलेंडर पर समय को ब्लॉक करता है या नहीं. ज़रूरी नहीं. संभावित वैल्यू ये हैं: "`opaque`" - डिफ़ॉल्ट वैल्यू. इवेंट, कैलेंडर पर समय को ब्लॉक कर देता है. यह कैलेंडर यूज़र इंटरफ़ेस (यूआई) में मुझे इस रूप में दिखाएं को व्यस्त पर सेट करने के बराबर है. "`transparent`" - इवेंट, कैलेंडर पर समय को ब्लॉक नहीं करता है. यह कैलेंडर यूज़र इंटरफ़ेस (यूआई) में मुझे इस रूप में दिखाएं को उपलब्ध पर सेट करने के बराबर है.	लिखा जा सकता है
`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`	कैलेंडर वेब और मोबाइल क्लाइंट में दिखाया गया ऑफ़िस का नाम. हमारा सुझाव है कि आप संगठन के संसाधनों के डेटाबेस में मौजूद इमारत का नाम देखें.	लिखा जा सकता है
`workingLocationProperties.type`	`string`	काम करने की जगह का टाइप. संभावित वैल्यू ये हैं: "`homeOffice`" - उपयोगकर्ता घर से काम कर रहा है. "`officeLocation`" - उपयोगकर्ता किसी ऑफ़िस से काम कर रहा है. "`customLocation`" - उपयोगकर्ता किसी कस्टम जगह से काम कर रहा है. नाम के सब-फ़ील्ड में कोई भी जानकारी दी गई होती है. हालांकि, अगर यह फ़ील्ड खाली है, तो हो सकता है कि इसमें कोई जानकारी न हो. इसके अलावा, अन्य फ़ील्ड को अनदेखा कर दिया जाता है. काम करने की जगह की जानकारी जोड़ने के लिए ज़रूरी है.	लिखा जा सकता है

जवाब

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

उदाहरण

ध्यान दें: इस तरीके के लिए दिए गए कोड के उदाहरणों में इसके साथ काम करने वाली सभी प्रोग्रामिंग भाषाएं नहीं दिखाई गई हैं (इसके साथ काम करने वाली भाषाओं की सूची के लिए क्लाइंट लाइब्रेरी वाला पेज देखें).

Java

Java क्लाइंट लाइब्रेरी का इस्तेमाल करता है.

// Refer to the Java quickstart on how to setup the environment:
// https://developers.google.com/calendar/quickstart/java
// Change the scope to CalendarScopes.CALENDAR and delete any stored
// credentials.

Event event = new Event()
    .setSummary("Google I/O 2015")
    .setLocation("800 Howard St., San Francisco, CA 94103")
    .setDescription("A chance to hear more about Google's developer products.");

DateTime startDateTime = new DateTime("2015-05-28T09:00:00-07:00");
EventDateTime start = new EventDateTime()
    .setDateTime(startDateTime)
    .setTimeZone("America/Los_Angeles");
event.setStart(start);

DateTime endDateTime = new DateTime("2015-05-28T17:00:00-07:00");
EventDateTime end = new EventDateTime()
    .setDateTime(endDateTime)
    .setTimeZone("America/Los_Angeles");
event.setEnd(end);

String[] recurrence = new String[] {"RRULE:FREQ=DAILY;COUNT=2"};
event.setRecurrence(Arrays.asList(recurrence));

EventAttendee[] attendees = new EventAttendee[] {
    new EventAttendee().setEmail("lpage@example.com"),
    new EventAttendee().setEmail("sbrin@example.com"),
};
event.setAttendees(Arrays.asList(attendees));

EventReminder[] reminderOverrides = new EventReminder[] {
    new EventReminder().setMethod("email").setMinutes(24 * 60),
    new EventReminder().setMethod("popup").setMinutes(10),
};
Event.Reminders reminders = new Event.Reminders()
    .setUseDefault(false)
    .setOverrides(Arrays.asList(reminderOverrides));
event.setReminders(reminders);

String calendarId = "primary";
event = service.events().insert(calendarId, event).execute();
System.out.printf("Event created: %s\n", event.getHtmlLink());

Python

Python क्लाइंट लाइब्रेरी का इस्तेमाल किया जाता है.

# Refer to the Python quickstart on how to setup the environment:
# https://developers.google.com/calendar/quickstart/python
# Change the scope to 'https://www.googleapis.com/auth/calendar' and delete any
# stored credentials.

event = {
  'summary': 'Google I/O 2015',
  'location': '800 Howard St., San Francisco, CA 94103',
  'description': 'A chance to hear more about Google\'s developer products.',
  'start': {
    'dateTime': '2015-05-28T09:00:00-07:00',
    'timeZone': 'America/Los_Angeles',
  },
  'end': {
    'dateTime': '2015-05-28T17:00:00-07:00',
    'timeZone': 'America/Los_Angeles',
  },
  'recurrence': [
    'RRULE:FREQ=DAILY;COUNT=2'
  ],
  'attendees': [
    {'email': 'lpage@example.com'},
    {'email': 'sbrin@example.com'},
  ],
  'reminders': {
    'useDefault': False,
    'overrides': [
      {'method': 'email', 'minutes': 24 * 60},
      {'method': 'popup', 'minutes': 10},
    ],
  },
}

event = service.events().insert(calendarId='primary', body=event).execute()
print 'Event created: %s' % (event.get('htmlLink'))

PHP

PHP क्लाइंट लाइब्रेरी का इस्तेमाल किया जाता है.

// Refer to the PHP quickstart on how to setup the environment:
// https://developers.google.com/calendar/quickstart/php
// Change the scope to Google_Service_Calendar::CALENDAR and delete any stored
// credentials.

$event = new Google_Service_Calendar_Event(array(
  'summary' => 'Google I/O 2015',
  'location' => '800 Howard St., San Francisco, CA 94103',
  'description' => 'A chance to hear more about Google\'s developer products.',
  'start' => array(
    'dateTime' => '2015-05-28T09:00:00-07:00',
    'timeZone' => 'America/Los_Angeles',
  ),
  'end' => array(
    'dateTime' => '2015-05-28T17:00:00-07:00',
    'timeZone' => 'America/Los_Angeles',
  ),
  'recurrence' => array(
    'RRULE:FREQ=DAILY;COUNT=2'
  ),
  'attendees' => array(
    array('email' => 'lpage@example.com'),
    array('email' => 'sbrin@example.com'),
  ),
  'reminders' => array(
    'useDefault' => FALSE,
    'overrides' => array(
      array('method' => 'email', 'minutes' => 24 * 60),
      array('method' => 'popup', 'minutes' => 10),
    ),
  ),
));

$calendarId = 'primary';
$event = $service->events->insert($calendarId, $event);
printf('Event created: %s\n', $event->htmlLink);

Ruby

Ruby क्लाइंट लाइब्रेरी का इस्तेमाल करता हो.

event = Google::Apis::CalendarV3::Event.new(
  summary: 'Google I/O 2015',
  location: '800 Howard St., San Francisco, CA 94103',
  description: 'A chance to hear more about Google\'s developer products.',
  start: Google::Apis::CalendarV3::EventDateTime.new(
    date_time: '2015-05-28T09:00:00-07:00',
    time_zone: 'America/Los_Angeles'
  ),
  end: Google::Apis::CalendarV3::EventDateTime.new(
    date_time: '2015-05-28T17:00:00-07:00',
    time_zone: 'America/Los_Angeles'
  ),
  recurrence: [
    'RRULE:FREQ=DAILY;COUNT=2'
  ],
  attendees: [
    Google::Apis::CalendarV3::EventAttendee.new(
      email: 'lpage@example.com'
    ),
    Google::Apis::CalendarV3::EventAttendee.new(
      email: 'sbrin@example.com'
    )
  ],
  reminders: Google::Apis::CalendarV3::Event::Reminders.new(
    use_default: false,
    overrides: [
      Google::Apis::CalendarV3::EventReminder.new(
        reminder_method: 'email',
        minutes: 24 * 60
      ),
      Google::Apis::CalendarV3::EventReminder.new(
        reminder_method: 'popup',
        minutes: 10
      )
    ]
  )
)

result = client.insert_event('primary', event)
puts "Event created: #{result.html_link}"

.NET

.NET क्लाइंट लाइब्रेरी का इस्तेमाल किया जाता है.

// Refer to the .NET quickstart on how to setup the environment:
// https://developers.google.com/calendar/quickstart/dotnet
// Change the scope to CalendarService.Scope.Calendar and delete any stored
// credentials.

Event newEvent = new Event()
{
    Summary = "Google I/O 2015",
    Location = "800 Howard St., San Francisco, CA 94103",
    Description = "A chance to hear more about Google's developer products.",
    Start = new EventDateTime()
    {
        DateTime = DateTime.Parse("2015-05-28T09:00:00-07:00"),
        TimeZone = "America/Los_Angeles",
    },
    End = new EventDateTime()
    {
        DateTime = DateTime.Parse("2015-05-28T17:00:00-07:00"),
        TimeZone = "America/Los_Angeles",
    },
    Recurrence = new String[] { "RRULE:FREQ=DAILY;COUNT=2" },
    Attendees = new EventAttendee[] {
        new EventAttendee() { Email = "lpage@example.com" },
        new EventAttendee() { Email = "sbrin@example.com" },
    },
    Reminders = new Event.RemindersData()
    {
        UseDefault = false,
        Overrides = new EventReminder[] {
            new EventReminder() { Method = "email", Minutes = 24 * 60 },
            new EventReminder() { Method = "sms", Minutes = 10 },
        }
    }
};

String calendarId = "primary";
EventsResource.InsertRequest request = service.Events.Insert(newEvent, calendarId);
Event createdEvent = request.Execute();
Console.WriteLine("Event created: {0}", createdEvent.HtmlLink);

शुरू करें

Go क्लाइंट लाइब्रेरी का इस्तेमाल करता है.

// Refer to the Go quickstart on how to setup the environment:
// https://developers.google.com/calendar/quickstart/go
// Change the scope to calendar.CalendarScope and delete any stored credentials.

event := &calendar.Event{
  Summary: "Google I/O 2015",
  Location: "800 Howard St., San Francisco, CA 94103",
  Description: "A chance to hear more about Google's developer products.",
  Start: &calendar.EventDateTime{
    DateTime: "2015-05-28T09:00:00-07:00",
    TimeZone: "America/Los_Angeles",
  },
  End: &calendar.EventDateTime{
    DateTime: "2015-05-28T17:00:00-07:00",
    TimeZone: "America/Los_Angeles",
  },
  Recurrence: []string{"RRULE:FREQ=DAILY;COUNT=2"},
  Attendees: []*calendar.EventAttendee{
    &calendar.EventAttendee{Email:"lpage@example.com"},
    &calendar.EventAttendee{Email:"sbrin@example.com"},
  },
}

calendarId := "primary"
event, err = srv.Events.Insert(calendarId, event).Do()
if err != nil {
  log.Fatalf("Unable to create event. %v\n", err)
}
fmt.Printf("Event created: %s\n", event.HtmlLink)

JavaScript

JavaScript क्लाइंट लाइब्रेरी का इस्तेमाल किया जाता है.

// Refer to the JavaScript quickstart on how to setup the environment:
// https://developers.google.com/calendar/quickstart/js
// Change the scope to 'https://www.googleapis.com/auth/calendar' and delete any
// stored credentials.

var event = {
  'summary': 'Google I/O 2015',
  'location': '800 Howard St., San Francisco, CA 94103',
  'description': 'A chance to hear more about Google\'s developer products.',
  'start': {
    'dateTime': '2015-05-28T09:00:00-07:00',
    'timeZone': 'America/Los_Angeles'
  },
  'end': {
    'dateTime': '2015-05-28T17:00:00-07:00',
    'timeZone': 'America/Los_Angeles'
  },
  'recurrence': [
    'RRULE:FREQ=DAILY;COUNT=2'
  ],
  'attendees': [
    {'email': 'lpage@example.com'},
    {'email': 'sbrin@example.com'}
  ],
  'reminders': {
    'useDefault': false,
    'overrides': [
      {'method': 'email', 'minutes': 24 * 60},
      {'method': 'popup', 'minutes': 10}
    ]
  }
};

var request = gapi.client.calendar.events.insert({
  'calendarId': 'primary',
  'resource': event
});

request.execute(function(event) {
  appendPre('Event created: ' + event.htmlLink);
});

Node.js

Node.js क्लाइंट लाइब्रेरी का इस्तेमाल करता है.

// Refer to the Node.js quickstart on how to setup the environment:
// https://developers.google.com/calendar/quickstart/node
// Change the scope to 'https://www.googleapis.com/auth/calendar' and delete any
// stored credentials.

var event = {
  'summary': 'Google I/O 2015',
  'location': '800 Howard St., San Francisco, CA 94103',
  'description': 'A chance to hear more about Google\'s developer products.',
  'start': {
    'dateTime': '2015-05-28T09:00:00-07:00',
    'timeZone': 'America/Los_Angeles',
  },
  'end': {
    'dateTime': '2015-05-28T17:00:00-07:00',
    'timeZone': 'America/Los_Angeles',
  },
  'recurrence': [
    'RRULE:FREQ=DAILY;COUNT=2'
  ],
  'attendees': [
    {'email': 'lpage@example.com'},
    {'email': 'sbrin@example.com'},
  ],
  'reminders': {
    'useDefault': false,
    'overrides': [
      {'method': 'email', 'minutes': 24 * 60},
      {'method': 'popup', 'minutes': 10},
    ],
  },
};

calendar.events.insert({
  auth: auth,
  calendarId: 'primary',
  resource: event,
}, function(err, event) {
  if (err) {
    console.log('There was an error contacting the Calendar service: ' + err);
    return;
  }
  console.log('Event created: %s', event.htmlLink);
});

इसे आज़माएं!

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