Events: insert

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

अनुरोध

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

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

पैरामीटर

पैरामीटर का नाम मान ब्यौरा
पाथ पैरामीटर
calendarId string Calendar आइडेंटिफ़ायर. कैलेंडर आईडी पाने के लिए, calendarList.list तरीके को कॉल करें. अगर आपको फ़िलहाल लॉग इन किए हुए उपयोगकर्ता का प्राइमरी कैलेंडर ऐक्सेस करना है, तो "primary" कीवर्ड का इस्तेमाल करें.
ज़रूरी नहीं क्वेरी पैरामीटर
conferenceDataVersion integer एपीआई क्लाइंट के साथ काम करने वाले कॉन्फ़्रेंस डेटा का वर्शन नंबर. वर्शन 0 में यह माना जाता है कि कॉन्फ़्रेंस डेटा काम नहीं करता. साथ ही, यह इवेंट के मुख्य हिस्से में मौजूद कॉन्फ़्रेंस डेटा को अनदेखा करता है. पहले वर्शन में, ConferenceData को कॉपी करने के साथ-साथ, conferenceData के createRequest फ़ील्ड का इस्तेमाल करके नई कॉन्फ़्रेंस बनाने की सुविधा भी मिलती है. डिफ़ॉल्ट वैल्यू 0 है. 0 से 1 तक की वैल्यू ही स्वीकार की जाती हैं.
maxAttendees integer जवाब में शामिल किए जाने वाले मेहमानों की ज़्यादा से ज़्यादा संख्या. अगर मीटिंग में हिस्सा लेने वाले लोगों की संख्या, तय की गई संख्या से ज़्यादा है, तो सिर्फ़ मीटिंग में हिस्सा लेने वाले व्यक्ति की जानकारी दिखेगी. ज़रूरी नहीं.
sendNotifications boolean समर्थन नहीं होना या रुकना. इसके बजाय, कृपया sendUpdates का इस्तेमाल करें.

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

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

अनुमति देना

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

दायरा
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 क्या कोई भी व्यक्ति खुद को इवेंट में शामिल होने का न्योता भेज सकता है (अब काम नहीं करता). ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होता है. लिखा जा सकता है
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" - मेहमान ने न्योता स्वीकार कर लिया है.
 लिखा जा सकता है
birthdayProperties nested object जन्मदिन या खास इवेंट का डेटा. अगर eventType "birthday" है, तो इसका इस्तेमाल किया जाता है. इम्यूटेबल. लिखा जा सकता है
birthdayProperties.type string जन्मदिन या खास इवेंट का टाइप. वैल्यू इस तरह की हो सकती हैं:
  • "anniversary" - जन्मदिन के अलावा कोई दूसरी सालगिरह. इसमें हमेशा contact होता है.
  • "birthday" - जन्मदिन का इवेंट. यह डिफ़ॉल्ट मान है.
  • "custom" - कोई खास तारीख, जिसका लेबल customTypeName फ़ील्ड में दिया गया है. इसमें हमेशा contact होता है.
  • "other" - कोई खास तारीख, जो किसी दूसरी कैटगरी में नहीं आती और जिसका कोई कस्टम लेबल नहीं होता. इसमें हमेशा contact होता है.
  • "self" - कैलेंडर के मालिक का जन्मदिन. contact नहीं हो सकता.
Calendar API, सिर्फ़ "birthday" टाइप के इवेंट बनाने की सुविधा देता है. इवेंट बनाने के बाद, उसका टाइप नहीं बदला जा सकता.		 लिखा जा सकता है
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 वह टाइम ज़ोन जिसमें समय बताया गया है. (आईएएनए टाइम ज़ोन डेटाबेस के नाम के तौर पर फ़ॉर्मैट किया गया, जैसे कि "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 पिक्सल में गैजेट की ऊंचाई. ऊंचाई ऐसी पूरी संख्या होनी चाहिए जो 0 से ज़्यादा हो. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. लिखा जा सकता है
gadget.preferences object प्राथमिकताएं पर क्लिक करें. लिखा जा सकता है
gadget.title string गैजेट का टाइटल. समर्थन नहीं होना या रुकना. लिखा जा सकता है
gadget.type string गैजेट का टाइप. समर्थन नहीं होना या रुकना. लिखा जा सकता है
gadget.width integer पिक्सल में गैजेट की चौड़ाई. चौड़ाई, शून्य से ज़्यादा की कोई पूरी संख्या होनी चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. लिखा जा सकता है
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 वह टाइम ज़ोन जिसमें समय बताया गया है. (आईएएनए टाइम ज़ोन डेटाबेस के नाम के तौर पर फ़ॉर्मैट किया गया, जैसे कि "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 को 'गलत है' पर सेट करके किए गए इंक्रीमेंटल सिंक के अनुरोधों से यह जानकारी नहीं मिलेगी.

    अगर किसी इवेंट का आयोजक बदल जाता है (उदाहरण के लिए, इवेंट को एक से दूसरे कैलेंडर में ले जाने की सुविधा का इस्तेमाल करके) और मूल आयोजक, मेहमानों की सूची में शामिल नहीं है, तो रद्द किया गया इवेंट बन जाएगा. इसमें सिर्फ़ 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" - उपयोगकर्ता किसी कस्टम जगह से काम कर रहा है.
कोई भी जानकारी, बताए गए नाम के सब-फ़ील्ड में दी जाती है. हालांकि, अगर यह फ़ील्ड खाली है, तो हो सकता है कि यह मौजूद न हो. अन्य सभी फ़ील्ड को अनदेखा कर दिया जाता है.

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

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

जवाब

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

इसे आज़माएं!

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