Events: insert

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

अनुरोध

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

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

पैरामीटर

पैरामीटर का नाम वैल्यू ब्यौरा
पाथ पैरामीटर
calendarId string कैलेंडर आइडेंटिफ़ायर. कैलेंडर आईडी पाने के लिए, calendarList.list तरीके को कॉल करें. अगर आपको उस उपयोगकर्ता का मुख्य कैलेंडर ऐक्सेस करना है जिसने फ़िलहाल लॉग इन किया हुआ है, तो "primary" कीवर्ड का इस्तेमाल करें.
वैकल्पिक क्वेरी पैरामीटर
conferenceDataVersion integer एपीआई क्लाइंट के साथ काम करने वाले कॉन्फ़्रेंस डेटा का वर्शन नंबर. वर्शन 0 में यह मान लिया जाता है कि इसमें कॉन्फ़्रेंस का डेटा शामिल नहीं है. साथ ही, यह इवेंट के मुख्य हिस्से में मौजूद कॉन्फ़्रेंस डेटा को अनदेखा कर देता है. वर्शन 1 में कॉन्फ़्रेंस डेटा को कॉपी करने की सुविधा चालू की गई है. साथ ही, इसका इस्तेमाल करके कॉन्फ़्रेंस डेटा के 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

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

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

अनुरोध के मुख्य हिस्से में, नीचे दी गई प्रॉपर्टी के साथ इवेंट संसाधन दें:

प्रॉपर्टी का नाम वैल्यू ब्यौरा ज़रूरी जानकारी
ज़रूरी प्रॉपर्टी
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" - मेहमान ने न्योता स्वीकार कर लिया है.
लिखा जा सकता है
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 इवेंट का खास टाइप. इवेंट बनाए जाने के बाद, इसमें बदलाव नहीं किया जा सकता. संभावित वैल्यू ये हैं:
  • "default" - सामान्य इवेंट या तय नहीं किया गया है.
  • "outOfOffice" - 'अभी मैं छुट्टी पर हूं' इवेंट.
  • "focusTime" - फ़ोकस-टाइम इवेंट.
  • "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 पिक्सल में गैजेट की चौड़ाई. चौड़ाई की वैल्यू 0 से ज़्यादा पूर्णांक होनी चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. लिखा जा सकता है
guestsCanInviteOthers boolean क्या आयोजक के अलावा, दूसरे मेहमान अन्य लोगों को इवेंट में शामिल होने का न्योता भेज सकते हैं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से यह 'सही' पर सेट होती है. लिखा जा सकता है
guestsCanModify boolean क्या आयोजक के अलावा दूसरे मेहमान इवेंट में बदलाव कर सकते हैं. ज़रूरी नहीं. डिफ़ॉल्ट वैल्यू 'गलत' पर सेट होती है. लिखा जा सकता है
guestsCanSeeOtherGuests boolean क्या आयोजक के अलावा अन्य मेहमान यह देख सकते हैं कि इवेंट में कौन-कौन शामिल हैं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से यह 'सही' पर सेट होती है. लिखा जा सकता है
id string इवेंट का ओपेक आइडेंटिफ़ायर. नए सिंगल या बार-बार होने वाले इवेंट बनाते समय, उनके आईडी तय किए जा सकते हैं. दिए गए आईडी को इन नियमों के मुताबिक होना चाहिए:
  • आईडी में डाले जाने वाले वर्ण, base32hex एन्कोडिंग में इस्तेमाल किए जाते हैं, जैसे कि अंग्रेज़ी के छोटे अक्षर a-v और अंक 0-9. RFC2938 में सेक्शन 3.1.2 देखें
  • आईडी की लंबाई 5 से 1024 वर्णों के बीच होनी चाहिए
  • हर कैलेंडर के लिए आईडी यूनीक होना चाहिए
यह सिस्टम दुनिया भर में डिस्ट्रिब्यूट होता है. इसलिए, हम इस बात की गारंटी नहीं दे सकते कि इवेंट बनाते समय, आईडी की वजह से होने वाली गड़बड़ियों का पता लगाया जाएगा. टकराव के जोखिम को कम करने के लिए, हम एक पहले से मौजूद यूयूआईडी एल्गोरिदम का इस्तेमाल करने का सुझाव देते हैं. जैसा कि 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 बार-बार होने वाले इवेंट के लिए RTERMS, EXTerms, RDATE, और EXDATE लाइनों की सूची. इसके बारे में RFC5545 में बताया गया है. ध्यान दें कि इस फ़ील्ड में DTSTART और DTEND लाइनों की अनुमति नहीं है. इवेंट के शुरू और खत्म होने के समय की जानकारी, start और end फ़ील्ड में दी गई है. यह फ़ील्ड किसी एक इवेंट या बार-बार होने वाले इवेंट के लिए इस्तेमाल नहीं किया जाता है. लिखा जा सकता है
reminders.overrides[] list अगर इवेंट में डिफ़ॉल्ट रिमाइंडर का इस्तेमाल नहीं किया जाता है, तो यह इवेंट के लिए खास रिमाइंडर की सूची बनाता है. अगर सेट नहीं किया गया है, तो यह बताता है कि इस इवेंट के लिए कोई रिमाइंडर सेट नहीं किया गया है. बदलाव करने के लिए, ज़्यादा से ज़्यादा पांच रिमाइंडर इस्तेमाल किए जा सकते हैं. लिखा जा सकता है
reminders.overrides[].method string इस रिमाइंडर के लिए इस्तेमाल किया गया तरीका. संभावित वैल्यू ये हैं:
  • "email" - रिमाइंडर ईमेल से भेजे जाते हैं.
  • "popup" - रिमाइंडर, यूज़र इंटरफ़ेस (यूआई) पॉप-अप की मदद से भेजे जाते हैं.

रिमाइंडर जोड़ते समय ज़रूरी है.

लिखा जा सकता है
reminders.overrides[].minutes integer इवेंट शुरू होने से पहले के मिनट में, रिमाइंडर कब ट्रिगर होना चाहिए. मान्य वैल्यू 0 और 40320 के बीच की होती हैं (मिनट में 4 हफ़्ते).

रिमाइंडर जोड़ते समय ज़रूरी है.

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

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

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

जवाब

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

उदाहरण

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

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);
});

इसे आज़माएं!

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