इस कुकी का इस्तेमाल, किसी इवेंट को इंपोर्ट करने के लिए किया जाता है. इस ऑपरेशन का इस्तेमाल, किसी कैलेंडर में मौजूदा इवेंट की निजी कॉपी जोड़ने के लिए किया जाता है. सिर्फ़ default के eventType वाले इवेंट इंपोर्ट किए जा सकते हैं.
अब काम नहीं करता: अगर कोई ऐसा इवेंट इंपोर्ट किया जाता है जो default नहीं है, तो उसका टाइप default में बदल जाएगा. साथ ही, इवेंट टाइप के हिसाब से उसकी प्रॉपर्टी हटा दी जाएंगी.
अनुरोध
एचटीटीपी अनुरोध
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/import
पैरामीटर
| पैरामीटर का नाम | मान | ब्यौरा |
|---|---|---|
| पाथ पैरामीटर | ||
calendarId |
string |
कैलेंडर का आइडेंटिफ़ायर. कैलेंडर आईडी वापस पाने के लिए, calendarList.list तरीके को कॉल करें. अगर आपको फ़िलहाल लॉग इन किए गए उपयोगकर्ता के प्राइमरी कैलेंडर को ऐक्सेस करना है, तो "primary" कीवर्ड का इस्तेमाल करें.
|
| वैकल्पिक क्वेरी पैरामीटर | ||
conferenceDataVersion |
integer |
एपीआई क्लाइंट के साथ काम करने वाले कॉन्फ़्रेंस डेटा का वर्शन नंबर. वर्शन 0 में, कॉन्फ़्रेंस डेटा के साथ काम करने की सुविधा नहीं होती है. साथ ही, यह इवेंट के मुख्य हिस्से में मौजूद कॉन्फ़्रेंस डेटा को अनदेखा करता है. वर्शन 1 में, ConferenceData को कॉपी करने की सुविधा मिलती है. साथ ही, इसमें conferenceData के createRequest फ़ील्ड का इस्तेमाल करके नई कॉन्फ़्रेंस बनाने की सुविधा भी मिलती है. डिफ़ॉल्ट वैल्यू 0 होती है.
मान्य वैल्यू 0 से 1 तक हैं. इसमें 0 और 1 भी शामिल हैं.
|
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 |
इवेंट के खत्म होने का समय (अलग से उपलब्ध). बार-बार होने वाले इवेंट के लिए, यह पहले इंस्टेंस के खत्म होने का समय होता है. | |
iCalUID |
string |
RFC5545 में बताए गए इवेंट का यूनीक आइडेंटिफ़ायर. इसका इस्तेमाल, कैलेंडर सिस्टम में इवेंट की पहचान करने के लिए किया जाता है. साथ ही, import तरीके से इवेंट इंपोर्ट करते समय, इसे उपलब्ध कराना ज़रूरी है. ध्यान दें कि |
|
start |
nested object |
इवेंट के शुरू होने का समय (शामिल है). बार-बार होने वाले इवेंट के लिए, यह पहले इंस्टेंस के शुरू होने का समय होता है. | |
| ज़रूरी नहीं है | |||
anyoneCanAddSelf |
boolean |
यह तय करता है कि कोई भी व्यक्ति इवेंट में शामिल होने का न्योता खुद को भेज सकता है या नहीं (अब इस्तेमाल नहीं किया जाता). ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह False पर सेट होता है. | लिखा जा सकता है |
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 |
क्या यह वैकल्पिक तौर पर शामिल होने वाला व्यक्ति है. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह False पर सेट होता है. | लिखा जा सकता है |
attendees[].resource |
boolean |
क्या शामिल होने वाला व्यक्ति कोई संसाधन है. इस विकल्प को सिर्फ़ तब सेट किया जा सकता है, जब किसी व्यक्ति को पहली बार इवेंट में शामिल किया जाता है. इसके बाद किए गए बदलावों को अनदेखा कर दिया जाता है. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह False पर सेट होता है. | लिखा जा सकता है |
attendees[].responseStatus |
string |
मीटिंग में शामिल होने वाले व्यक्ति के जवाब की स्थिति. इन वैल्यू का इस्तेमाल किया जा सकता है:
|
लिखा जा सकता है |
attendeesOmitted |
boolean |
इससे पता चलता है कि इवेंट में शामिल होने वाले लोगों को इवेंट के ब्यौरे में शामिल नहीं किया गया है. किसी इवेंट को वापस पाने के दौरान, ऐसा maxAttendee क्वेरी पैरामीटर की वजह से हो सकता है. किसी इवेंट को अपडेट करते समय, इसका इस्तेमाल सिर्फ़ इवेंट में हिस्सा लेने वाले व्यक्ति के जवाब को अपडेट करने के लिए किया जा सकता है. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह False पर सेट होता है. |
लिखा जा सकता है |
colorId |
string |
इवेंट का रंग. यह एक ऐसा आईडी है जो रंग की परिभाषा के event सेक्शन में मौजूद किसी एंट्री को दिखाता है. इसके बारे में जानने के लिए, colors एंडपॉइंट देखें. ज़रूरी नहीं. |
लिखा जा सकता है |
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 Time Zone Database के नाम के तौर पर फ़ॉर्मैट किया गया है. उदाहरण के लिए, "Europe/Zurich".) बार-बार होने वाले इवेंट के लिए, इस फ़ील्ड की ज़रूरत होती है. इससे उस टाइम ज़ोन के बारे में पता चलता है जिसमें इवेंट को दोहराया जाता है. किसी खास इवेंट के लिए, यह फ़ील्ड भरना ज़रूरी नहीं है. इससे इवेंट के शुरू/खत्म होने के लिए कस्टम टाइम ज़ोन का पता चलता है. | लिखा जा सकता है |
extendedProperties.private |
object |
ऐसी प्रॉपर्टी जो इस कैलेंडर पर दिखने वाले इवेंट की कॉपी के लिए निजी होती हैं. | लिखा जा सकता है |
extendedProperties.shared |
object |
ये ऐसी प्रॉपर्टी होती हैं जिन्हें इवेंट में शामिल अन्य लोगों के कैलेंडर पर, इवेंट की कॉपी के बीच शेयर किया जाता है. | लिखा जा सकता है |
focusTimeProperties |
nested object |
फ़ोकस टाइम इवेंट का डेटा. अगर eventType focusTime है, तो इसका इस्तेमाल किया जाता है. |
लिखा जा सकता है |
gadget.display |
string |
गैजेट का डिसप्ले मोड. समर्थन नहीं होना या रुकना. इन वैल्यू का इस्तेमाल किया जा सकता है:
|
लिखा जा सकता है |
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 पर सेट होता है. | लिखा जा सकता है |
location |
string |
इवेंट की भौगोलिक जगह के बारे में बिना स्ट्रक्चर वाला टेक्स्ट. ज़रूरी नहीं. | लिखा जा सकता है |
organizer |
object |
इवेंट का आयोजक. अगर मीटिंग आयोजित करने वाला व्यक्ति भी शामिल होने वाला व्यक्ति है, तो इसे attendees में अलग एंट्री के तौर पर दिखाया जाता है. साथ ही, organizer फ़ील्ड को 'सही' पर सेट किया जाता है. आयोजक को बदलने के लिए, move ऑपरेशन का इस्तेमाल करें. इवेंट इंपोर्ट करने के अलावा, सिर्फ़ देखने की अनुमति. |
लिखा जा सकता है |
organizer.displayName |
string |
अगर उपलब्ध हो, तो आयोजक का नाम. | लिखा जा सकता है |
organizer.email |
string |
अगर उपलब्ध हो, तो इवेंट के आयोजक का ईमेल पता. यह RFC5322 के मुताबिक एक मान्य ईमेल पता होना चाहिए. | लिखा जा सकता है |
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 |
इस रिमाइंडर के लिए इस्तेमाल किया गया तरीका. इन वैल्यू का इस्तेमाल किया जा सकता है:
रिमाइंडर जोड़ने के लिए ज़रूरी है. |
लिखा जा सकता है |
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 |
इवेंट की स्थिति. ज़रूरी नहीं. इन वैल्यू का इस्तेमाल किया जा सकता है:
|
लिखा जा सकता है |
summary |
string |
इवेंट का शीर्षक. | लिखा जा सकता है |
transparency |
string |
इससे पता चलता है कि इवेंट, कैलेंडर में समय ब्लॉक करता है या नहीं. ज़रूरी नहीं. इन वैल्यू का इस्तेमाल किया जा सकता है:
|
लिखा जा सकता है |
visibility |
string |
इवेंट किसको दिखे. ज़रूरी नहीं. इन वैल्यू का इस्तेमाल किया जा सकता है:
|
लिखा जा सकता है |
जवाब
अगर यह तरीका काम करता है, तो जवाब के मुख्य हिस्से में Events संसाधन दिखता है.
इसे आज़माएं!
लाइव डेटा पर इस तरीके को कॉल करने और जवाब देखने के लिए, यहां दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.