इवेंट इंपोर्ट करता है. इस ऑपरेशन का इस्तेमाल, किसी मौजूदा इवेंट की निजी कॉपी को कैलेंडर में जोड़ने के लिए किया जाता है. सिर्फ़ ऐसे इवेंट इंपोर्ट किए जा सकते हैं जिनका eventType default हो.
अब काम न करने वाला तरीका: अगर कोई ऐसा इवेंट इंपोर्ट किया जाता है जो default नहीं है, तो उसका टाइप default में बदल दिया जाएगा. साथ ही, उसमें मौजूद इवेंट टाइप से जुड़ी सभी प्रॉपर्टी हटा दी जाएंगी.
अनुरोध
एचटीटीपी अनुरोध
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/import
पैरामीटर
| पैरामीटर का नाम | मान | ब्यौरा | 
|---|---|---|
| पाथ पैरामीटर | ||
calendarId | 
        string | 
        
          Calendar आइडेंटिफ़ायर. कैलेंडर आईडी पाने के लिए, calendarList.list तरीके को कॉल करें. अगर आपको फ़िलहाल लॉग इन किए हुए उपयोगकर्ता का प्राइमरी कैलेंडर ऐक्सेस करना है, तो "primary" कीवर्ड का इस्तेमाल करें.
         | 
      
| ज़रूरी नहीं क्वेरी पैरामीटर | ||
conferenceDataVersion | 
        integer | 
        
          एपीआई क्लाइंट के साथ काम करने वाले कॉन्फ़्रेंस डेटा का वर्शन नंबर. वर्शन 0 में यह माना जाता है कि कॉन्फ़्रेंस डेटा काम नहीं करता. साथ ही, यह इवेंट के मुख्य हिस्से में मौजूद कॉन्फ़्रेंस डेटा को अनदेखा करता है. पहले वर्शन में, ConferenceData को कॉपी करने के साथ-साथ, conferenceData के createRequest फ़ील्ड का इस्तेमाल करके नई कॉन्फ़्रेंस बनाने की सुविधा भी मिलती है. डिफ़ॉल्ट वैल्यू 0 है.
          0 से 1 तक की वैल्यू ही स्वीकार की जाती हैं.
         | 
      
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 | 
        इवेंट के खत्म होने का समय. बार-बार होने वाले इवेंट के लिए, यह पहले इवेंट के खत्म होने का समय होता है. | |
iCalUID | 
        string | 
        RFC5545 में बताए गए मुताबिक, इवेंट का यूनीक आइडेंटिफ़ायर. इसका इस्तेमाल, कैलेंडर सिस्टम में मौजूद इवेंट की खास पहचान करने के लिए किया जाता है. साथ ही, इंपोर्ट तरीके से इवेंट इंपोर्ट करते समय, यह एट्रिब्यूट देना ज़रूरी है.   ध्यान दें कि   | 
        |
start | 
        nested object | 
        इवेंट के शुरू होने का समय. बार-बार होने वाले इवेंट के लिए, यह पहले इंस्टेंस के शुरू होने का समय होता है. | |
| ज़रूरी नहीं प्रॉपर्टी | |||
anyoneCanAddSelf | 
        boolean | 
        क्या कोई भी व्यक्ति खुद को इवेंट में शामिल होने का न्योता भेज सकता है (अब काम नहीं करता). ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होता है. | लिखा जा सकता है | 
attachments[].fileUrl | 
        string | 
        अटैचमेंट का यूआरएल लिंक.   Google Drive में मौजूद फ़ाइल अटैचमेंट जोड़ने के लिए, उसी फ़ॉर्मैट का इस्तेमाल करें जो Drive API में  अटैचमेंट जोड़ते समय ज़रूरी है.  | 
        लिखा जा सकता है | 
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 | 
        मीटिंग में हिस्सा लेने वाले व्यक्ति के जवाब की स्थिति. वैल्यू इस तरह की हो सकती हैं: 
  | 
        लिखा जा सकता है | 
attendeesOmitted | 
        boolean | 
        क्या इवेंट के रेप्रज़ेंटेशन में मेहमानों को शामिल नहीं किया गया है. किसी इवेंट को वापस लाने पर, ऐसा maxAttendee क्वेरी पैरामीटर की बताई गई पाबंदी की वजह से हो सकता है. किसी इवेंट को अपडेट करते समय, इसका इस्तेमाल सिर्फ़ हिस्सा लेने वाले व्यक्ति के जवाब को अपडेट करने के लिए किया जा सकता है. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होता है. | 
        लिखा जा सकता है | 
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".) बार-बार होने वाले इवेंट के लिए, यह फ़ील्ड ज़रूरी है. इससे उस टाइम ज़ोन की जानकारी मिलती है जिसमें इवेंट दोहराया जाता है. एक बार होने वाले इवेंट के लिए, यह फ़ील्ड ज़रूरी नहीं है. यह इवेंट के शुरू/खत्म होने के लिए, कस्टम टाइम ज़ोन दिखाता है. | लिखा जा सकता है | 
extendedProperties.private | 
        object | 
        इस कैलेंडर पर दिखने वाले इवेंट की कॉपी के लिए निजी प्रॉपर्टी. | लिखा जा सकता है | 
extendedProperties.shared | 
        object | 
        ऐसी प्रॉपर्टी जो इवेंट की कॉपी के बीच शेयर की जाती हैं. ये प्रॉपर्टी, इवेंट में शामिल अन्य लोगों के कैलेंडर पर मौजूद होती हैं. | लिखा जा सकता है | 
focusTimeProperties | 
        nested object | 
        फ़ोकस टाइम इवेंट का डेटा. अगर eventType focusTime है, तो इसका इस्तेमाल किया जाता है. | 
        लिखा जा सकता है | 
gadget.display | 
        string | 
        गैजेट का डिसप्ले मोड. समर्थन नहीं होना या रुकना. वैल्यू इस तरह की हो सकती हैं: 
  | 
        लिखा जा सकता है | 
gadget.height | 
        integer | 
        पिक्सल में गैजेट की ऊंचाई. ऊंचाई ऐसी पूरी संख्या होनी चाहिए जो 0 से ज़्यादा हो. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. | लिखा जा सकता है | 
gadget.iconLink | 
        string | 
        गैजेट के आइकॉन का यूआरएल. यूआरएल स्कीम, एचटीटीपीएस होना चाहिए. समर्थन नहीं होना या रुकना. | लिखा जा सकता है | 
gadget.link | 
        string | 
        गैजेट का यूआरएल. यूआरएल स्कीम, एचटीटीपीएस होना चाहिए. समर्थन नहीं होना या रुकना. | लिखा जा सकता है | 
gadget.preferences | 
        object | 
        प्राथमिकताएं पर क्लिक करें. | लिखा जा सकता है | 
gadget.title | 
        string | 
        गैजेट का टाइटल. समर्थन नहीं होना या रुकना. | लिखा जा सकता है | 
gadget.type | 
        string | 
        गैजेट का टाइप. समर्थन नहीं होना या रुकना. | लिखा जा सकता है | 
gadget.width | 
        integer | 
        पिक्सल में गैजेट की चौड़ाई. चौड़ाई, शून्य से ज़्यादा की कोई पूरी संख्या होनी चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. | लिखा जा सकता है | 
guestsCanInviteOthers | 
        boolean | 
        आयोजक के अलावा, इवेंट में शामिल होने वाले अन्य लोग, दूसरे लोगों को न्योता भेज सकते हैं या नहीं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह 'सही' पर सेट होता है. | लिखा जा सकता है | 
guestsCanModify | 
        boolean | 
        इवेंट के आयोजक के अलावा, दूसरे लोग इवेंट में बदलाव कर सकते हैं या नहीं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होता है. | लिखा जा सकता है | 
guestsCanSeeOtherGuests | 
        boolean | 
        आयोजक के अलावा, इवेंट में शामिल अन्य लोग यह देख सकते हैं कि इवेंट में कौन-कौन शामिल है. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह 'सही' पर सेट होता है. | लिखा जा सकता है | 
location | 
        string | 
        इवेंट की भौगोलिक जगह, बिना स्ट्रक्चर वाले टेक्स्ट के तौर पर. ज़रूरी नहीं. | लिखा जा सकता है | 
organizer | 
        object | 
        इवेंट का आयोजक. अगर आयोजक भी मीटिंग में शामिल है, तो इसकी जानकारी attendees में अलग से दी जाती है. साथ ही, organizer फ़ील्ड को 'सही' पर सेट किया जाता है. मीटिंग के आयोजक को बदलने के लिए, मूव करें विकल्प का इस्तेमाल करें. सिर्फ़ पढ़ने के लिए, सिवाय किसी इवेंट को इंपोर्ट करने के. | 
        लिखा जा सकता है | 
organizer.displayName | 
        string | 
        अगर उपलब्ध हो, तो आयोजक का नाम. | लिखा जा सकता है | 
organizer.email | 
        string | 
        अगर उपलब्ध हो, तो आयोजक का ईमेल पता. यह RFC5322 के मुताबिक मान्य ईमेल पता होना चाहिए. | लिखा जा सकता है | 
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 | 
        इस रिमाइंडर के लिए इस्तेमाल किया गया तरीका. वैल्यू इस तरह की हो सकती हैं: 
 रिमाइंडर जोड़ते समय ज़रूरी है.  | 
        लिखा जा सकता है | 
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 | 
        इवेंट की स्थिति. ज़रूरी नहीं. वैल्यू इस तरह की हो सकती हैं: 
  | 
        लिखा जा सकता है | 
summary | 
        string | 
        इवेंट का शीर्षक. | लिखा जा सकता है | 
transparency | 
        string | 
        इवेंट, कैलेंडर पर समय ब्लॉक करता है या नहीं. ज़रूरी नहीं. वैल्यू इस तरह की हो सकती हैं: 
  | 
        लिखा जा सकता है | 
visibility | 
        string | 
        इवेंट किसको दिखे. ज़रूरी नहीं. वैल्यू इस तरह की हो सकती हैं: 
  | 
        लिखा जा सकता है | 
जवाब
अगर यह तरीका कामयाब होता है, तो यह जवाब के मुख्य हिस्से में इवेंट रिसॉर्स दिखाता है.
इसे आज़माएं!
लाइव डेटा पर इस तरीके को कॉल करने और रिस्पॉन्स देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.