कोई इवेंट इंपोर्ट करता है. इस कार्रवाई का इस्तेमाल किसी मौजूदा इवेंट की एक निजी कॉपी को किसी कैलेंडर में जोड़ने के लिए किया जाता है. इसे अभी आज़माएं या उदाहरण देखें.
अनुरोध करें
एचटीटीपी अनुरोध
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/import
पैरामीटर
पैरामीटर का नाम | वैल्यू | जानकारी |
---|---|---|
पाथ पैरामीटर | ||
calendarId |
string |
कैलेंडर आइडेंटिफ़ायर. कैलेंडर आईडी फिर से पाने के लिए, calendarList.list तरीके पर कॉल करें. फ़िलहाल, लॉग इन किए हुए उपयोगकर्ता के मुख्य कैलेंडर को ऐक्सेस करने के लिए, "primary " कीवर्ड का इस्तेमाल करें.
|
वैकल्पिक क्वेरी पैरामीटर | ||
conferenceDataVersion |
integer |
एपीआई क्लाइंट के साथ काम करने वाले कॉन्फ़्रेंस डेटा का वर्शन नंबर. वर्शन 0 में, कॉन्फ़्रेंस डेटा के लिए कोई सहायता नहीं मिलती है. साथ ही, इवेंट के मुख्य हिस्से में कॉन्फ़्रेंस डेटा को अनदेखा किया जाता है. इस वर्शन 2 में कॉन्फ़्रेंस डेटा को कॉपी किया जा सकता है. साथ ही, कॉन्फ़्रेंस डेटा के CreateRequest फ़ील्ड का इस्तेमाल करके नई कॉन्फ़्रेंस बनाई जा सकती हैं. डिफ़ॉल्ट सेटिंग 0 होती है.
0 से 1 तक के मान स्वीकार किए जाते हैं.
|
supportsAttachments |
boolean |
एपीआई क्लाइंट की कार्रवाई, इवेंट अटैचमेंट के साथ काम करती है या नहीं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, 'गलत है' पर क्लिक किया जाता है. |
अनुमति देना
इस अनुरोध के लिए इनमें से कम से कम एक दायरे की अनुमति ज़रूरी है:
अनुमति देने का |
---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
ज़्यादा जानकारी के लिए, पुष्टि और अनुमति देना पेज देखें.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इन प्रॉपर्टी के साथ इवेंट संसाधन उपलब्ध कराएं:
प्रॉपर्टी का नाम | वैल्यू | जानकारी | नोट |
---|---|---|---|
ज़रूरी प्रॉपर्टी | |||
end |
nested object |
इवेंट के खत्म होने का (खास समय). किसी बार-बार होने वाले इवेंट के लिए, यह पहले इंस्टेंस का खत्म होने का समय है. | |
iCalUID |
string |
आरएफ़सी5545 में बताए गए तरीके से, इवेंट का यूनीक आइडेंटिफ़ायर. इसका इस्तेमाल, कैलेंडर सिस्टम में इवेंट की पहचान करने के लिए किया जाता है. साथ ही, इवेंट को इंपोर्ट करने के तरीके से इंपोर्ट करना ज़रूरी है. ध्यान दें कि |
|
start |
nested object |
इवेंट के शुरू होने का समय (शामिल है) किसी बार-बार होने वाले इवेंट के लिए, यह पहले इंस्टेंस का शुरू होने का समय है. | |
ज़रूरी प्रॉपर्टी नहीं | |||
anyoneCanAddSelf |
boolean |
इवेंट में किसी को भी न्योता दिया जा सकता है या नहीं (अब यह सुविधा बंद है). ज़रूरी नहीं. डिफ़ॉल्ट रूप से, 'गलत है' पर क्लिक किया जाता है. | लिखा जा सकता है |
attachments[].fileUrl |
string |
अटैचमेंट का यूआरएल लिंक. Google Drive में मौजूद फ़ाइल के अटैचमेंट जोड़ने के लिए, Drive एपीआई में मौजूद अटैचमेंट जोड़ते समय ज़रूरी है. |
लिखा जा सकता है |
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 |
समय क्षेत्र जिसमें समय बताया गया है. (IANA समय क्षेत्र डेटाबेस नाम, जैसे "यूरोप/ज़्यूरिख" के रूप में फ़ॉर्मैट किया गया.) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी होता है. साथ ही, यह उस टाइम ज़ोन के बारे में भी बताता है जिसमें दोहराए जाने वाले इवेंट को बढ़ाया जाता है. यह इवेंट वैकल्पिक है और इवेंट के शुरू/खत्म होने के लिए कस्टम समय क्षेत्र दिखाता है. | लिखा जा सकता है |
extendedProperties.private |
object |
ऐसी प्रॉपर्टी जो इस कैलेंडर पर दिखने वाले इवेंट की कॉपी के साथ निजी होती हैं. | लिखा जा सकता है |
extendedProperties.shared |
object |
ऐसी प्रॉपर्टी जिन्हें मेहमानों के कैलेंडर पर, इवेंट की कॉपी के बीच शेयर किया जाता है. | लिखा जा सकता है |
gadget.display |
string |
गैजेट का प्रदर्शन मोड. समर्थन नहीं होना या रुकना. वैल्यू इस तरह की हो सकती हैं:
|
लिखा जा सकता है |
gadget.height |
integer |
गैजेट की ऊंचाई पिक्सल में. ऊंचाई 0 से ज़्यादा होना चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.iconLink |
string |
गैजेट के आइकॉन का यूआरएल. यूआरएल स्कीम एचटीटीपीएस होनी चाहिए. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.link |
string |
गैजेट का URL. यूआरएल स्कीम एचटीटीपीएस होनी चाहिए. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.preferences |
object |
प्राथमिकताएं पर टैप करें. | लिखा जा सकता है |
gadget.title |
string |
गैजेट का शीर्षक. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.type |
string |
गैजेट का प्रकार. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.width |
integer |
गैजेट की चौड़ाई पिक्सल में. चौड़ाई 0 से बड़ी कोई पूर्णांक संख्या होनी चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
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 |
समय क्षेत्र जिसमें समय बताया गया है. (IANA समय क्षेत्र डेटाबेस नाम, जैसे "यूरोप/ज़्यूरिख" के रूप में फ़ॉर्मैट किया गया.) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी होता है. साथ ही, यह उस टाइम ज़ोन के बारे में भी बताता है जिसमें दोहराए जाने वाले इवेंट को बढ़ाया जाता है. यह इवेंट वैकल्पिक है और इवेंट के शुरू/खत्म होने के लिए कस्टम समय क्षेत्र दिखाता है. | लिखा जा सकता है |
recurrence[] |
list |
आरएफ़सी5545 में बताए गए किसी बार-बार होने वाले इवेंट के लिए Rनियमों, EXREQUEST, RDATE, और EXDATE लाइनों की सूची. ध्यान दें कि इस फ़ील्ड में 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 समय क्षेत्र डेटाबेस नाम, जैसे "यूरोप/ज़्यूरिख" के रूप में फ़ॉर्मैट किया गया.) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी होता है. साथ ही, यह उस टाइम ज़ोन के बारे में भी बताता है जिसमें दोहराए जाने वाले इवेंट को बढ़ाया जाता है. यह इवेंट वैकल्पिक है और इवेंट के शुरू/खत्म होने के लिए कस्टम समय क्षेत्र दिखाता है. | लिखा जा सकता है |
status |
string |
इवेंट की स्थिति. ज़रूरी नहीं. वैल्यू इस तरह की हो सकती हैं:
|
लिखा जा सकता है |
summary |
string |
इवेंट का शीर्षक. | लिखा जा सकता है |
transparency |
string |
इवेंट, कैलेंडर पर समय को रोक रहा है या नहीं. ज़रूरी नहीं. वैल्यू इस तरह की हो सकती हैं:
|
लिखा जा सकता है |
visibility |
string |
इवेंट किसे दिखेगा. ज़रूरी नहीं. वैल्यू इस तरह की हो सकती हैं:
|
लिखा जा सकता है |
जवाब
अगर यह सफल होता है, तो यह तरीका रिस्पॉन्स के मुख्य भाग में इवेंट संसाधन दिखाता है.
उदाहरण
ध्यान दें: इस तरीके के लिए दिए गए कोड के उदाहरणों में इसके साथ काम करने वाली सभी प्रोग्रामिंग भाषाएं नहीं दिखाई गई हैं (इसके साथ काम करने वाली भाषाओं की सूची के लिए क्लाइंट लाइब्रेरी वाला पेज देखें).
Java
Java क्लाइंट लाइब्रेरी का इस्तेमाल करता है.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.Event; import com.google.api.services.calendar.model.EventAttendee; import com.google.api.services.calendar.model.EventDateTime; import com.google.api.client.util.DateTime; import java.util.Date; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Create and initialize a new event (could also retrieve an existing event) Event event = new Event(); event.setICalUID("originalUID"); Event.Organizer organizer = new Event.Organizer(); organizer.setEmail("organizerEmail"); organizer.setDisplayName("organizerDisplayName"); event.setOrganizer(organizer); ArrayList<EventAttendee> attendees = new ArrayList<EventAttendee>(); attendees.add(new EventAttendee().setEmail("attendeeEmail")); // ... event.setAttendees(attendees); Date startDate = new Date(); Date endDate = new Date(startDate.getTime() + 3600000); DateTime start = new DateTime(startDate, TimeZone.getTimeZone("UTC")); event.setStart(new EventDateTime().setDateTime(start)); DateTime end = new DateTime(endDate, TimeZone.getTimeZone("UTC")); event.setEnd(new EventDateTime().setDateTime(end)); // Import the event into a calendar Event importedEvent = service.events().calendarImport('primary', event).execute(); System.out.println(importedEvent.getId());
Python
Python क्लाइंट लाइब्रेरी का इस्तेमाल करता है.
event = { 'summary': 'Appointment', 'location': 'Somewhere', 'organizer': { 'email': 'organizerEmail', 'displayName': 'organizerDisplayName' }, 'start': { 'dateTime': '2011-06-03T10:00:00.000-07:00' }, 'end': { 'dateTime': '2011-06-03T10:25:00.000-07:00' }, 'attendees': [ { 'email': 'attendeeEmail', 'displayName': 'attendeeDisplayName', }, # ... ], 'iCalUID': 'originalUID' } imported_event = service.events().import_(calendarId='primary', body=event).execute() print imported_event['id']
PHP
PHP क्लाइंट लाइब्रेरी का इस्तेमाल करता है.
$event = new Google_Service_Calendar_Event(); $event->setSummary('Appointment'); $event->setLocation('Somewhere'); $start = new Google_Service_Calendar_EventDateTime(); $start->setDateTime('2011-06-03T10:00:00.000-07:00'); $event->setStart($start); $end = new Google_Service_Calendar_EventDateTime(); $end->setDateTime('2011-06-03T10:25:00.000-07:00'); $event->setEnd($end); $attendee1 = new Google_Service_Calendar_EventAttendee(); $attendee1->setEmail('attendeeEmail'); // ... $attendees = array($attendee1, // ..., ); $event->attendees = $attendees; $organizer = new Google_Service_Calendar_EventOrganizer(); $organizer->setEmail('organizerEmail'); $organizer->setDisplayName('organizerDisplayName'); $event->setOrganizer($organizer); $event->setICalUID('originalUID'); $importedEvent = $service->events->import('primary', $event); echo $importedEvent->getId();
Ruby
Ruby क्लाइंट लाइब्रेरी का इस्तेमाल करता है.
event = Google::Apis::CalendarV3::Event.new( summary: 'Appointment', location: 'Somewhere', organizer: { email: 'organizerEmail', display_name: 'organizerDisplayName' }, start: { date_time: '2011-06-03T10:00:00.000-07:00' }, end: { date_time: '2011-06-03T10:25:00.000-07:00' }, attendees: [ { email: 'attendeeEmail', display_name: 'attendeeDisplayName', }, # ... ], i_cal_uid: 'originalUID' ) result = client.import_event('primary', event) print result.id
इसे आज़माएं!
इस तरीके को लाइव डेटा पर कॉल करने और जवाब देखने के लिए, नीचे दिए गए एपीआई एक्सप्लोरर का इस्तेमाल करें.