Calendar API में, इवेंट के अलग-अलग वर्शन उपलब्ध कराए गए हैं. इस बारे में ज़्यादा जानने के लिए, इवेंट के बारे में जानकारी पर जाएं.
इस संसाधन के लिए उपलब्ध तरीकों की सूची देखने के लिए, इस पेज के आखिर में देखें.
संसाधन के तौर पर दिखाए जाने वाले आइटम
{ "kind": "calendar#event", "etag": etag, "id": string, "status": string, "htmlLink": string, "created": datetime, "updated": datetime, "summary": string, "description": string, "location": string, "colorId": string, "creator": { "id": string, "email": string, "displayName": string, "self": boolean }, "organizer": { "id": string, "email": string, "displayName": string, "self": boolean }, "start": { "date": date, "dateTime": datetime, "timeZone": string }, "end": { "date": date, "dateTime": datetime, "timeZone": string }, "endTimeUnspecified": boolean, "recurrence": [ string ], "recurringEventId": string, "originalStartTime": { "date": date, "dateTime": datetime, "timeZone": string }, "transparency": string, "visibility": string, "iCalUID": string, "sequence": integer, "attendees": [ { "id": string, "email": string, "displayName": string, "organizer": boolean, "self": boolean, "resource": boolean, "optional": boolean, "responseStatus": string, "comment": string, "additionalGuests": integer } ], "attendeesOmitted": boolean, "extendedProperties": { "private": { (key): string }, "shared": { (key): string } }, "hangoutLink": string, "conferenceData": { "createRequest": { "requestId": string, "conferenceSolutionKey": { "type": string }, "status": { "statusCode": string } }, "entryPoints": [ { "entryPointType": string, "uri": string, "label": string, "pin": string, "accessCode": string, "meetingCode": string, "passcode": string, "password": string } ], "conferenceSolution": { "key": { "type": string }, "name": string, "iconUri": string }, "conferenceId": string, "signature": string, "notes": string, }, "gadget": { "type": string, "title": string, "link": string, "iconLink": string, "width": integer, "height": integer, "display": string, "preferences": { (key): string } }, "anyoneCanAddSelf": boolean, "guestsCanInviteOthers": boolean, "guestsCanModify": boolean, "guestsCanSeeOtherGuests": boolean, "privateCopy": boolean, "locked": boolean, "reminders": { "useDefault": boolean, "overrides": [ { "method": string, "minutes": integer } ] }, "source": { "url": string, "title": string }, "workingLocationProperties": { "type": string, "homeOffice": (value), "customLocation": { "label": string }, "officeLocation": { "buildingId": string, "floorId": string, "floorSectionId": string, "deskId": string, "label": string } }, "outOfOfficeProperties": { "autoDeclineMode": string, "declineMessage": string }, "focusTimeProperties": { "autoDeclineMode": string, "declineMessage": string, "chatStatus": string }, "attachments": [ { "fileUrl": string, "title": string, "mimeType": string, "iconLink": string, "fileId": string } ], "birthdayProperties": { "contact": string, "type": string, "customTypeName": string }, "eventType": string }
प्रॉपर्टी का नाम | मान | ब्यौरा | नोट |
---|---|---|---|
anyoneCanAddSelf |
boolean |
क्या कोई भी व्यक्ति खुद को इवेंट में शामिल होने का न्योता भेज सकता है (अब काम नहीं करता). ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह वैल्यू 'गलत' पर सेट होती है. | लिखा जा सकता है |
attachments[] |
list |
इवेंट के लिए फ़ाइल अटैचमेंट. अटैचमेंट में बदलाव करने के लिए, हर इवेंट में ज़्यादा से ज़्यादा 25 अटैचमेंट हो सकते हैं, |
|
attachments[].fileId |
string |
अटैच की गई फ़ाइल का आईडी. सिर्फ़ पढ़ने के लिए. Google Drive फ़ाइलों के लिए, यह Drive API में |
|
attachments[].fileUrl |
string |
अटैचमेंट का यूआरएल लिंक. Google Drive में मौजूद फ़ाइल अटैचमेंट जोड़ने के लिए, उसी फ़ॉर्मैट का इस्तेमाल करें जिसका इस्तेमाल Drive API में, अटैचमेंट जोड़ते समय ज़रूरी है. |
लिखा जा सकता है |
attachments[].iconLink |
string |
अटैचमेंट के आइकॉन का यूआरएल लिंक. इस फ़ील्ड में सिर्फ़ तीसरे पक्ष के कस्टम अटैचमेंट के लिए बदलाव किया जा सकता है. | |
attachments[].mimeType |
string |
अटैचमेंट का इंटरनेट मीडिया टाइप (MIME टाइप). | |
attachments[].title |
string |
अटैचमेंट का टाइटल. | |
attendeesOmitted |
boolean |
क्या इवेंट के रेप्रज़ेंटेशन में मेहमानों को शामिल नहीं किया गया है. किसी इवेंट को वापस लाने पर, ऐसा maxAttendee क्वेरी पैरामीटर की बताई गई पाबंदी की वजह से हो सकता है. किसी इवेंट को अपडेट करते समय, इसकी मदद से सिर्फ़ मीटिंग में हिस्सा लेने वाले का जवाब अपडेट किया जा सकता है. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होता है. |
लिखा जा सकता है |
attendees[] |
list |
इवेंट में शामिल होने वाले लोग. कैलेंडर का इस्तेमाल करने वाले अन्य उपयोगकर्ताओं के साथ इवेंट शेड्यूल करने के बारे में ज़्यादा जानकारी के लिए, मेहमानों के साथ इवेंट वाली गाइड देखें. मीटिंग में हिस्सा लेने वाले लोगों की सूची भरने के लिए, सेवा खातों को डोमेन के लिए अनुमति देने की सुविधा का इस्तेमाल करना होगा. | लिखा जा सकता है |
attendees[].additionalGuests |
integer |
अतिरिक्त मेहमानों की संख्या. ज़रूरी नहीं. डिफ़ॉल्ट वैल्यू 0 होती है. | लिखा जा सकता है |
attendees[].comment |
string |
मीटिंग में हिस्सा लेने वाले व्यक्ति की टिप्पणी. ज़रूरी नहीं. | लिखा जा सकता है |
attendees[].displayName |
string |
मेहमान का नाम, अगर उपलब्ध हो. ज़रूरी नहीं. | लिखा जा सकता है |
attendees[].email |
string |
अगर उपलब्ध हो, तो मीटिंग में शामिल होने वाले व्यक्ति का ईमेल पता. मीटिंग में शामिल होने वाले व्यक्ति को जोड़ते समय, यह फ़ील्ड मौजूद होना चाहिए. यह RFC5322 के मुताबिक मान्य ईमेल पता होना चाहिए. किसी मेहमान को जोड़ते समय ज़रूरी है. |
लिखा जा सकता है |
attendees[].id |
string |
अगर उपलब्ध हो, तो मीटिंग में शामिल व्यक्ति का प्रोफ़ाइल आईडी. | |
attendees[].optional |
boolean |
क्या यह व्यक्ति मीटिंग में शामिल होना चाहता है. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह वैल्यू 'गलत' पर सेट होती है. | लिखा जा सकता है |
attendees[].organizer |
boolean |
मेहमान, इवेंट का आयोजक है या नहीं. सिर्फ़ पढ़ने के लिए. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होता है. | |
attendees[].resource |
boolean |
मीटिंग में शामिल व्यक्ति, संसाधन है या नहीं. यह सिर्फ़ तब सेट किया जा सकता है, जब इवेंट में किसी व्यक्ति को पहली बार जोड़ा गया हो. इसके बाद किए गए बदलावों को अनदेखा कर दिया जाता है. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होता है. | लिखा जा सकता है |
attendees[].responseStatus |
string |
मीटिंग में शामिल होने वाले व्यक्ति के जवाब की स्थिति. वैल्यू इस तरह की हो सकती हैं:
|
लिखा जा सकता है |
attendees[].self |
boolean |
यह जानकारी, उस कैलेंडर के बारे में बताती है जिस पर इवेंट की यह कॉपी दिखती है. सिर्फ़ पढ़ने के लिए. डिफ़ॉल्ट रूप से, यह वैल्यू 'गलत' पर सेट होती है. | |
birthdayProperties |
nested object |
जन्मदिन या खास इवेंट का डेटा. अगर eventType "birthday" है, तो इसका इस्तेमाल किया जाता है. इम्यूटेबल. |
लिखा जा सकता है |
birthdayProperties.contact |
string |
उस संपर्क का संसाधन नाम जिससे यह जन्मदिन का इवेंट जुड़ा है. इसका इस्तेमाल, People API से संपर्क की जानकारी फ़ेच करने के लिए किया जा सकता है. फ़ॉर्मैट: "people/c12345" . सिर्फ़ पढ़ने के लिए. |
|
birthdayProperties.customTypeName |
string |
इस इवेंट के लिए तय किया गया कस्टम टाइप लेबल. अगर birthdayProperties.type को "custom" पर सेट किया गया है, तो यह अपने-आप भर जाता है. सिर्फ़ पढ़ने के लिए. |
|
birthdayProperties.type |
string |
जन्मदिन या खास इवेंट का टाइप. संभावित वैल्यू ये हैं:
"birthday" टाइप के इवेंट बनाने की सुविधा देता है. इवेंट बनाने के बाद, उसका टाइप नहीं बदला जा सकता. |
लिखा जा सकता है |
colorId |
string |
इवेंट का रंग. यह आईडी, कलर डेफ़िनिशन के event सेक्शन में की गई एंट्री को रेफ़र करता है. ( कलर एंडपॉइंट देखें). ज़रूरी नहीं. |
लिखा जा सकता है |
conferenceData |
nested object |
कॉन्फ़्रेंस से जुड़ी जानकारी, जैसे कि Google Meet कॉन्फ़्रेंस की जानकारी. नई कॉन्फ़्रेंस की जानकारी डालने के लिए, createRequest फ़ील्ड का इस्तेमाल करें. अपने बदलावों को सेव करने के लिए, इवेंट में बदलाव करने के सभी अनुरोधों के लिए, conferenceDataVersion अनुरोध पैरामीटर को 1 पर सेट करना न भूलें. |
लिखा जा सकता है |
conferenceData.conferenceId |
string |
कॉन्फ़्रेंस का आईडी. इसका इस्तेमाल डेवलपर, कॉन्फ़्रेंस को ट्रैक करने के लिए कर सकते हैं. इसे उपयोगकर्ताओं को नहीं दिखाया जाना चाहिए. हर तरह के कॉन्फ़्रेंस सलूशन के लिए, आईडी वैल्यू अलग-अलग तरीके से बनाई जाती है:
|
|
conferenceData.conferenceSolution |
nested object |
कॉन्फ़्रेंसिंग सलूशन, जैसे कि Google Meet. कॉन्फ़्रेंस बनाने का अनुरोध पूरा न होने पर, उसे अनसेट करें.
|
|
conferenceData.conferenceSolution.iconUri |
string |
इस समाधान के लिए, उपयोगकर्ता को दिखने वाला आइकॉन. | |
conferenceData.conferenceSolution.key |
nested object |
यह वह कुंजी है जिससे इस इवेंट के लिए, कॉन्फ़्रेंस के समाधान की खास पहचान की जा सकती है. | |
conferenceData.conferenceSolution.key.type |
string |
कॉन्फ़्रेंसिंग के लिए इस्तेमाल किया जाने वाला सलूशन. अगर किसी क्लाइंट को कोई ऐसा टाइप मिलता है जो उसे नहीं पता या जो खाली है, तब भी वह एंट्री पॉइंट दिखा सकता है. हालांकि, इसमें बदलाव करने की अनुमति नहीं होनी चाहिए. ये वैल्यू हो सकती हैं:
|
|
conferenceData.conferenceSolution.name |
string |
इस समाधान का वह नाम जो उपयोगकर्ता को दिखता है. स्थानीय भाषा में नहीं है. | |
conferenceData.createRequest |
nested object |
नई कॉन्फ़्रेंस जनरेट करने और उसे इवेंट से जोड़ने का अनुरोध. डेटा एसिंक्रोनस तरीके से जनरेट होता है. डेटा मौजूद है या नहीं, यह देखने के लिए status फ़ील्ड देखें.
|
|
conferenceData.createRequest.conferenceSolutionKey |
nested object |
कॉन्फ़्रेंस के लिए इस्तेमाल किया जाने वाला सलूशन, जैसे कि Hangouts या Google Meet. | |
conferenceData.createRequest.conferenceSolutionKey.type |
string |
कॉन्फ़्रेंसिंग के लिए इस्तेमाल किया जाने वाला सलूशन. अगर किसी क्लाइंट को कोई ऐसा टाइप मिलता है जो उसे नहीं पता या जो खाली है, तब भी वह एंट्री पॉइंट दिखा सकता है. हालांकि, इसमें बदलाव करने की अनुमति नहीं होनी चाहिए. ये वैल्यू हो सकती हैं:
|
|
conferenceData.createRequest.requestId |
string |
इस अनुरोध के लिए क्लाइंट से जनरेट किया गया यूनीक आईडी. क्लाइंट को हर नए अनुरोध के लिए, यह आईडी फिर से जनरेट करना चाहिए. अगर दिया गया आईडी पिछले अनुरोध की तरह ही है, तो अनुरोध को अनदेखा कर दिया जाता है. |
|
conferenceData.createRequest.status |
nested object |
कॉन्फ़्रेंस बनाने के अनुरोध की स्थिति. | |
conferenceData.createRequest.status.statusCode |
string |
कॉन्फ़्रेंस बनाने के अनुरोध की मौजूदा स्थिति. सिर्फ़ पढ़ने के लिए. ये वैल्यू हो सकती हैं:
|
|
conferenceData.entryPoints[] |
list |
कॉन्फ़्रेंस के एंट्री पॉइंट के बारे में जानकारी, जैसे कि यूआरएल या फ़ोन नंबर. सभी शीट एक ही कॉन्फ़्रेंस से जुड़ी होनी चाहिए.
|
|
conferenceData.entryPoints[].accessCode |
string |
कॉन्फ़्रेंस को ऐक्सेस करने के लिए ऐक्सेस कोड. इसमें 128 से ज़्यादा वर्ण नहीं हो सकते. नया कॉन्फ़्रेंस डेटा बनाते समय, { ज़रूरी नहीं. |
|
conferenceData.entryPoints[].entryPointType |
string |
कॉन्फ़्रेंस के एंट्री पॉइंट का टाइप. संभावित वैल्यू ये हैं:
|
|
conferenceData.entryPoints[].label |
string |
यूआरआई का लेबल. असली उपयोगकर्ताओं को दिखता है. स्थानीय भाषा में नहीं है. इसमें 512 से ज़्यादा वर्ण नहीं हो सकते. उदाहरण:
ज़रूरी नहीं. |
|
conferenceData.entryPoints[].meetingCode |
string |
कॉन्फ़्रेंस को ऐक्सेस करने के लिए मीटिंग कोड. इसमें 128 से ज़्यादा वर्ण नहीं हो सकते. नया कॉन्फ़्रेंस डेटा बनाते समय, { ज़रूरी नहीं. |
|
conferenceData.entryPoints[].passcode |
string |
कॉन्फ़्रेंस को ऐक्सेस करने के लिए पासवर्ड. इसमें 128 से ज़्यादा वर्ण नहीं हो सकते. नया कॉन्फ़्रेंस डेटा बनाते समय, { |
|
conferenceData.entryPoints[].password |
string |
कॉन्फ़्रेंस को ऐक्सेस करने के लिए पासवर्ड. इसमें 128 से ज़्यादा वर्ण नहीं होने चाहिए. नया कॉन्फ़्रेंस डेटा बनाते समय, { ज़रूरी नहीं. |
|
conferenceData.entryPoints[].pin |
string |
कॉन्फ़्रेंस को ऐक्सेस करने के लिए पिन. इसमें 128 से ज़्यादा वर्ण नहीं होने चाहिए. नया कॉन्फ़्रेंस डेटा बनाते समय, { ज़रूरी नहीं. |
|
conferenceData.entryPoints[].uri |
string |
एंट्री पॉइंट का यूआरआई. इसमें ज़्यादा से ज़्यादा 1,300 वर्ण इस्तेमाल किए जा सकते हैं. फ़ॉर्मैट:
|
|
conferenceData.notes |
string |
उपयोगकर्ता को दिखाने के लिए अतिरिक्त नोट (जैसे, डोमेन एडमिन के निर्देश, कानूनी नोटिस). इसमें एचटीएमएल शामिल हो सकता है. ज़्यादा से ज़्यादा 2048 वर्ण हो सकते हैं. ज़रूरी नहीं. | |
conferenceData.signature |
string |
कॉन्फ़्रेंस डेटा का हस्ताक्षर. सर्वर साइड पर जनरेट किया जाता है. कॉन्फ़्रेंस बनाने का अनुरोध पूरा न होने पर, उसे अनसेट करें. अगर कॉन्फ़्रेंस बनाने का अनुरोध बाकी है, तो यह जानकारी देना ज़रूरी नहीं है. |
|
created |
datetime |
इवेंट बनाने का समय (RFC3339 टाइमस्टैंप के तौर पर). सिर्फ़ पढ़ने के लिए. | |
creator |
object |
इवेंट बनाने वाला क्रिएटर. सिर्फ़ पढ़ने के लिए. | |
creator.displayName |
string |
अगर उपलब्ध हो, तो क्रिएटर का नाम. | |
creator.email |
string |
अगर क्रिएटर का ईमेल पता उपलब्ध है, तो उसे शामिल करें. | |
creator.id |
string |
क्रिएटर का प्रोफ़ाइल आईडी, अगर उपलब्ध हो. | |
creator.self |
boolean |
क्रिएटर उस कैलेंडर से मेल खाता है या नहीं जिस पर इवेंट की यह कॉपी दिखती है. सिर्फ़ पढ़ने के लिए. डिफ़ॉल्ट रूप से, यह वैल्यू 'गलत' पर सेट होती है. | |
description |
string |
इवेंट के बारे में जानकारी. इसमें एचटीएमएल शामिल हो सकता है. ज़रूरी नहीं. | लिखा जा सकता है |
end |
nested object |
इवेंट के खत्म होने का समय. बार-बार होने वाले इवेंट के लिए, यह पहले इवेंट के खत्म होने का समय होता है. | |
end.date |
date |
अगर यह इवेंट पूरे दिन चलने वाला है, तो तारीख "yyyy-mm-dd" फ़ॉर्मैट में डालें. | लिखा जा सकता है |
end.dateTime |
datetime |
तारीख और समय की वैल्यू, जो RFC3339 के हिसाब से फ़ॉर्मैट की गई हो. टाइम ज़ोन ऑफ़सेट की वैल्यू देना ज़रूरी है. हालांकि, अगर timeZone में टाइम ज़ोन की जानकारी साफ़ तौर पर दी गई है, तो ऑफ़सेट की वैल्यू देना ज़रूरी नहीं है. |
लिखा जा सकता है |
end.timeZone |
string |
वह टाइम ज़ोन जिसमें समय बताया गया है. (आईएएनए टाइम ज़ोन डेटाबेस के नाम के तौर पर फ़ॉर्मैट किया गया, जैसे कि "Europe/Zurich".) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी है. साथ ही, यह उस टाइम ज़ोन के बारे में बताता है जिसमें बार-बार होने वाले इवेंट को बड़ा किया जाता है. एक बार होने वाले इवेंट के लिए, यह फ़ील्ड ज़रूरी नहीं है. यह इवेंट के शुरू/खत्म होने के लिए, कस्टम टाइम ज़ोन दिखाता है. | लिखा जा सकता है |
endTimeUnspecified |
boolean |
क्या असल में, इवेंट खत्म होने का समय नहीं बताया गया है. साथ काम करने की वजह से, खत्म होने का समय अब भी दिया जाता है. भले ही, इस एट्रिब्यूट को 'सही है' पर सेट किया गया हो. डिफ़ॉल्ट रूप से, यह वैल्यू 'गलत' पर सेट होती है. | |
etag |
etag |
संसाधन का ETag. | |
eventType |
string |
खास तरह का इवेंट. इवेंट बनाने के बाद, इस सेटिंग में बदलाव नहीं किया जा सकता. वैल्यू इस तरह की हो सकती हैं:
|
लिखा जा सकता है |
extendedProperties |
object |
इवेंट की एक्सटेंडेड प्रॉपर्टी. | |
extendedProperties.private |
object |
इस कैलेंडर पर दिखने वाले इवेंट की कॉपी के लिए निजी प्रॉपर्टी. | लिखा जा सकता है |
extendedProperties.private.(key) |
string |
निजी प्रॉपर्टी का नाम और उससे जुड़ी वैल्यू. | |
extendedProperties.shared |
object |
ऐसी प्रॉपर्टी जो इवेंट की कॉपी के बीच शेयर की जाती हैं. ये प्रॉपर्टी, इवेंट में शामिल अन्य लोगों के कैलेंडर पर मौजूद होती हैं. | लिखा जा सकता है |
extendedProperties.shared.(key) |
string |
शेयर की गई प्रॉपर्टी का नाम और उससे जुड़ी वैल्यू. | |
focusTimeProperties |
nested object |
फ़ोकस टाइम इवेंट का डेटा. अगर eventType focusTime है, तो इसका इस्तेमाल किया जाता है. |
लिखा जा सकता है |
focusTimeProperties.autoDeclineMode |
string |
फ़ोकस टाइम इवेंट को ओवरलैप करने वाली मीटिंग के न्योते अस्वीकार किए जाएं या नहीं. मान्य वैल्यू declineNone हैं, जिसका मतलब है कि मीटिंग के किसी भी न्योते को अस्वीकार नहीं किया जाएगा; declineAllConflictingInvitations , जिसका मतलब है कि इवेंट के साथ होने वाली मीटिंग के सभी न्योते अस्वीकार कर दिए जाएंगे; और declineOnlyNewConflictingInvitations , जिसका मतलब है कि फ़ोकस टाइम इवेंट के दौरान मिलने वाले, मीटिंग के सिर्फ़ नए न्योते अस्वीकार किए जाएंगे. |
|
focusTimeProperties.chatStatus |
string |
Chat और मिलते-जुलते प्रॉडक्ट में उपयोगकर्ता को मार्क करने के लिए स्टेटस. यह available या doNotDisturb हो सकता है. |
|
focusTimeProperties.declineMessage |
string |
अगर Calendar किसी मौजूदा इवेंट या नए न्योते को अपने-आप अस्वीकार कर देता है, तो जवाब के तौर पर यह मैसेज सेट किया जा सकता है. | |
gadget |
object |
यह इवेंट एक्सटेंड करने वाला गैजेट है. गैजेट अब काम नहीं करते. इस स्ट्रक्चर का इस्तेमाल, सिर्फ़ जन्मदिन के कैलेंडर मेटाडेटा को लौटाने के लिए किया जाता है. | |
gadget.display |
string |
गैजेट का प्रदर्शन मोड. समर्थन नहीं होना या रुकना. वैल्यू इस तरह की हो सकती हैं:
|
लिखा जा सकता है |
gadget.height |
integer |
पिक्सल में गैजेट की ऊंचाई. ऊंचाई, शून्य से बड़ी पूर्णांक होनी चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.iconLink |
string |
गैजेट के आइकन का URL. यूआरएल स्कीम, एचटीटीपीएस होना चाहिए. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.link |
string |
गैजेट का यूआरएल. यूआरएल स्कीम, एचटीटीपीएस होना चाहिए. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.preferences |
object |
प्राथमिकताएं पर क्लिक करें. | लिखा जा सकता है |
gadget.preferences.(key) |
string |
प्राथमिकता का नाम और उससे जुड़ी वैल्यू. | |
gadget.title |
string |
गैजेट का टाइटल. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.type |
string |
गैजेट का टाइप. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.width |
integer |
पिक्सल में गैजेट की चौड़ाई. चौड़ाई, शून्य से बड़ी कोई पूरी संख्या होनी चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
guestsCanInviteOthers |
boolean |
क्या आयोजक के अलावा अन्य उपस्थित व्यक्ति इवेंट में अन्य लोगों को आमंत्रित कर सकते हैं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह 'सही' पर सेट होता है. | लिखा जा सकता है |
guestsCanModify |
boolean |
इवेंट के आयोजक के अलावा, दूसरे लोग इवेंट में बदलाव कर सकते हैं या नहीं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होता है. | लिखा जा सकता है |
guestsCanSeeOtherGuests |
boolean |
आयोजक के अलावा, इवेंट में शामिल अन्य लोग यह देख सकते हैं कि इवेंट में कौन-कौन शामिल है. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, यह 'सही' पर सेट होता है. | लिखा जा सकता है |
hangoutLink |
string |
इस इवेंट से जुड़े Google Hangout का पूरा लिंक. सिर्फ़ पढ़ने के लिए. | |
htmlLink |
string |
Google Calendar के वेब यूज़र इंटरफ़ेस (यूआई) में इस इवेंट का ऐब्सलूट लिंक. सिर्फ़ पढ़ने के लिए. | |
iCalUID |
string |
RFC5545 में बताए गए मुताबिक, इवेंट का यूनीक आइडेंटिफ़ायर. इसका इस्तेमाल, कैलेंडर सिस्टम में मौजूद इवेंट की खास पहचान करने के लिए किया जाता है. साथ ही, import तरीके से इवेंट इंपोर्ट करते समय, यह एट्रिब्यूट देना ज़रूरी है. ध्यान दें कि |
|
id |
string |
इवेंट का ओपेक आइडेंटिफ़ायर. नए सिंगल या बार-बार होने वाले इवेंट बनाते समय, उनके आईडी तय किए जा सकते हैं. दिए गए आईडी, इन नियमों के मुताबिक होने चाहिए:
अगर आप कोई आईडी नहीं बताते हैं, तो सर्वर अपने-आप उसे जनरेट कर देगा. ध्यान दें कि |
लिखा जा सकता है |
kind |
string |
संसाधन का टाइप ("calendar#event "). |
|
location |
string |
इवेंट की भौगोलिक जगह, बिना स्ट्रक्चर वाले टेक्स्ट के तौर पर. ज़रूरी नहीं. | लिखा जा सकता है |
locked |
boolean |
यह इवेंट की लॉक की गई कॉपी है या नहीं. लॉक की गई इवेंट कॉपी में, इवेंट के मुख्य फ़ील्ड "खास जानकारी", "ब्यौरा", "जगह", "शुरू होने का समय", "खत्म होने का समय" या "बार-बार होने की जानकारी" में कोई बदलाव नहीं किया जा सकता. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होता है. रीड-ओनली. | |
organizer |
object |
इवेंट का आयोजक. अगर आयोजक भी मीटिंग में शामिल है, तो इसकी जानकारी attendees में एक अलग एंट्री के तौर पर दी जाती है. साथ ही, organizer फ़ील्ड को 'सही' पर सेट किया जाता है. मीटिंग के आयोजक को बदलने के लिए, मूव ऑपरेशन का इस्तेमाल करें. सिर्फ़ पढ़ने के लिए, इवेंट इंपोर्ट करने पर नहीं. |
लिखा जा सकता है |
organizer.displayName |
string |
अगर उपलब्ध हो, तो आयोजक का नाम. | लिखा जा सकता है |
organizer.email |
string |
अगर उपलब्ध हो, तो आयोजक का ईमेल पता. यह RFC5322 के मुताबिक मान्य ईमेल पता होना चाहिए. | लिखा जा सकता है |
organizer.id |
string |
आयोजक का प्रोफ़ाइल आईडी, अगर उपलब्ध हो. | |
organizer.self |
boolean |
आयोजक उस कैलेंडर से मेल खाता है या नहीं जिस पर इवेंट की यह कॉपी दिखती है. सिर्फ़ पढ़ने के लिए. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होता है. | |
originalStartTime |
nested object |
बार-बार होने वाले इवेंट की स्थिति के लिए, यह वह समय है जब यह बार-बार होने वाले इवेंट के बार-बार होने वाले डेटा के हिसाब से शुरू होगा. इस डेटा की पहचान बार-बार होने वाले इवेंट के डेटा के आधार पर की जाती है. यह बार-बार होने वाली इवेंट सीरीज़ में, इंस्टेंस की खास पहचान करता है. भले ही, इंस्टेंस को किसी दूसरे समय पर ले जाया गया हो. इम्यूटेबल. | |
originalStartTime.date |
date |
अगर यह इवेंट पूरे दिन का है, तो तारीख "yyyy-mm-dd" फ़ॉर्मैट में डालें. | लिखा जा सकता है |
originalStartTime.dateTime |
datetime |
समय, तारीख और समय की मिली-जुली वैल्यू के तौर पर (RFC3339 के हिसाब से फ़ॉर्मैट किया गया). टाइम ज़ोन ऑफ़सेट की वैल्यू देना ज़रूरी है. हालांकि, अगर timeZone में टाइम ज़ोन की जानकारी साफ़ तौर पर दी गई है, तो ऑफ़सेट की वैल्यू देना ज़रूरी नहीं है. |
लिखा जा सकता है |
originalStartTime.timeZone |
string |
वह टाइम ज़ोन जिसमें समय बताया गया है. (आईएएनए टाइम ज़ोन डेटाबेस के नाम के तौर पर फ़ॉर्मैट किया गया, जैसे कि "Europe/Zurich".) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी है. साथ ही, यह उस टाइम ज़ोन के बारे में बताता है जिसमें बार-बार होने वाले इवेंट को बड़ा किया जाता है. एक बार होने वाले इवेंट के लिए, यह फ़ील्ड ज़रूरी नहीं है. यह इवेंट के शुरू/खत्म होने के लिए, कस्टम टाइम ज़ोन दिखाता है. | लिखा जा सकता है |
outOfOfficeProperties |
nested object |
'अभी मैं छुट्टी पर हूं' इवेंट का डेटा. अगर eventType , outOfOffice है, तो इस्तेमाल किया जाता है. |
लिखा जा सकता है |
outOfOfficeProperties.autoDeclineMode |
string |
'अभी मैं छुट्टी पर हूं' इवेंट के दौरान होने वाली मीटिंग के न्योते अस्वीकार करने का विकल्प. मान्य वैल्यू declineNone हैं, जिसका मतलब है कि मीटिंग के किसी भी न्योते को अस्वीकार नहीं किया जाएगा; declineAllConflictingInvitations , जिसका मतलब है कि इवेंट के साथ होने वाली मीटिंग के सभी न्योते अस्वीकार कर दिए जाएंगे; और declineOnlyNewConflictingInvitations , जिसका मतलब है कि 'अभी मैं छुट्टी पर हूं' इवेंट के मौजूद होने पर, सिर्फ़ नई मीटिंग के उन न्योतों को अस्वीकार किया जाएगा जो उस इवेंट के साथ होने वाली मीटिंग के न्योतों से मेल खाते हैं. |
|
outOfOfficeProperties.declineMessage |
string |
यह सेट करने के लिए रिस्पॉन्स मैसेज कि कोई मौजूदा इवेंट या नया न्योता, Calendar अपने-आप अस्वीकार कर दे. | |
privateCopy |
boolean |
अगर इसे 'सही है' पर सेट किया जाता है, तो इवेंट का प्रॉपेगेशन बंद हो जाता है. ध्यान दें कि यह निजी इवेंट प्रॉपर्टी जैसी चीज़ नहीं है. ज़रूरी नहीं. इम्यूटेबल. डिफ़ॉल्ट रूप से, यह वैल्यू 'गलत' पर सेट होती है. | |
recurrence[] |
list |
बार-बार होने वाले इवेंट के लिए RRULE, EXRULE, RDATE, और EXDATE लाइनों की सूची, जैसा कि RFC5545 में बताया गया है. ध्यान दें कि इस फ़ील्ड में DTSTART और DTEND लाइन का इस्तेमाल नहीं किया जा सकता. इवेंट के शुरू और खत्म होने का समय, start और end फ़ील्ड में बताया जाता है. इस फ़ील्ड को, एक बार होने वाले इवेंट या बार-बार होने वाले इवेंट के इंस्टेंस के लिए शामिल नहीं किया जाता. |
लिखा जा सकता है |
recurringEventId |
string |
बार-बार होने वाले इवेंट के किसी इंस्टेंस के लिए, यह उस बार-बार होने वाले इवेंट का id होता है जिससे यह इंस्टेंस जुड़ा होता है. इम्यूटेबल. |
|
reminders |
object |
पुष्टि किए गए उपयोगकर्ता के लिए, इवेंट के रिमाइंडर की जानकारी. ध्यान दें कि रिमाइंडर बदलने से, बंद होने वाले इवेंट की updated प्रॉपर्टी भी नहीं बदलती. |
|
reminders.overrides[] |
list |
अगर इवेंट में डिफ़ॉल्ट रिमाइंडर का इस्तेमाल नहीं किया जाता है, तो इसमें इवेंट के लिए खास तौर पर सेट किए गए रिमाइंडर दिखते हैं. अगर रिमाइंडर सेट नहीं किए गए हैं, तो इससे पता चलता है कि इस इवेंट के लिए कोई रिमाइंडर सेट नहीं किया गया है. ज़्यादा से ज़्यादा पांच रिमाइंडर बदले जा सकते हैं. | लिखा जा सकता है |
reminders.overrides[].method |
string |
इस रिमाइंडर के लिए इस्तेमाल किया गया तरीका. वैल्यू इस तरह की हो सकती हैं:
रिमाइंडर जोड़ते समय ज़रूरी है. |
लिखा जा सकता है |
reminders.overrides[].minutes |
integer |
इवेंट शुरू होने से कितने मिनट पहले रिमाइंडर ट्रिगर होना चाहिए. मान्य वैल्यू 0 से 40320 के बीच हैं (मिनट में चार हफ़्ते). रिमाइंडर जोड़ते समय ज़रूरी है. |
लिखा जा सकता है |
reminders.useDefault |
boolean |
इवेंट पर कैलेंडर के डिफ़ॉल्ट रिमाइंडर लागू होंगे या नहीं. | लिखा जा सकता है |
sequence |
integer |
iCalendar के हिसाब से क्रम का नंबर. | लिखा जा सकता है |
source |
object |
वह सोर्स जहां से इवेंट बनाया गया था. उदाहरण के लिए, कोई वेब पेज, ईमेल मैसेज या कोई ऐसा दस्तावेज़ जिसकी पहचान एचटीटीपी या एचटीटीपीएस स्कीम वाले यूआरएल से की जा सकती है. इवेंट का क्रिएटर ही इसे देख सकता है या इसमें बदलाव कर सकता है. | |
source.title |
string |
सोर्स का टाइटल. उदाहरण के लिए, किसी वेब पेज या ईमेल का विषय. | लिखा जा सकता है |
source.url |
string |
किसी संसाधन पर ले जाने वाले सोर्स का यूआरएल. यूआरएल स्कीम, एचटीटीपी या एचटीटीपीएस होना चाहिए. | लिखा जा सकता है |
start |
nested object |
इवेंट के शुरू होने का समय. बार-बार होने वाले इवेंट के लिए, यह पहले इंस्टेंस के शुरू होने का समय होता है. | |
start.date |
date |
अगर यह इवेंट पूरे दिन चलने वाला है, तो तारीख "yyyy-mm-dd" फ़ॉर्मैट में डालें. | लिखा जा सकता है |
start.dateTime |
datetime |
तारीख और समय की वैल्यू, जो RFC3339 के हिसाब से फ़ॉर्मैट की गई हो. टाइम ज़ोन ऑफ़सेट की वैल्यू देना ज़रूरी है. हालांकि, अगर timeZone में टाइम ज़ोन की जानकारी साफ़ तौर पर दी गई है, तो ऑफ़सेट की वैल्यू देना ज़रूरी नहीं है. |
लिखा जा सकता है |
start.timeZone |
string |
वह टाइम ज़ोन जिसमें समय बताया गया है. (आईएएनए टाइम ज़ोन डेटाबेस के नाम के तौर पर फ़ॉर्मैट किया गया, जैसे कि "Europe/Zurich".) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी है. साथ ही, यह उस टाइम ज़ोन के बारे में बताता है जिसमें बार-बार होने वाले इवेंट को बड़ा किया जाता है. एक बार होने वाले इवेंट के लिए, यह फ़ील्ड ज़रूरी नहीं है. यह इवेंट के शुरू/खत्म होने के लिए, कस्टम टाइम ज़ोन दिखाता है. | लिखा जा सकता है |
status |
string |
इवेंट की स्थिति. ज़रूरी नहीं. वैल्यू इस तरह की हो सकती हैं:
|
लिखा जा सकता है |
summary |
string |
इवेंट का शीर्षक. | लिखा जा सकता है |
transparency |
string |
इवेंट, कैलेंडर पर समय ब्लॉक करता है या नहीं. ज़रूरी नहीं. वैल्यू इस तरह की हो सकती हैं:
|
लिखा जा सकता है |
updated |
datetime |
मुख्य इवेंट डेटा में बदलाव करने का आखिरी समय (RFC3339 टाइमस्टैंप के तौर पर). इवेंट के रिमाइंडर अपडेट करने से, इस पर कोई असर नहीं पड़ेगा. सिर्फ़ पढ़ने के लिए. | |
visibility |
string |
इवेंट किसको दिखे. ज़रूरी नहीं. वैल्यू इस तरह की हो सकती हैं:
|
लिखा जा सकता है |
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 |
काम करने की जगह का टाइप. वैल्यू इस तरह की हो सकती हैं:
काम करने की जगह की जानकारी वाली प्रॉपर्टी जोड़ते समय ज़रूरी है. |
लिखा जा सकता है |
तरीके
- मिटाएं
- इवेंट मिटाता है.
- get
- Google Calendar आईडी के आधार पर इवेंट दिखाता है. किसी इवेंट के iCalendar आईडी का इस्तेमाल करके उसे वापस पाने के लिए,
iCalUID
पैरामीटर का इस्तेमाल करके events.list का तरीका कॉल करें. - import
- कोई इवेंट इंपोर्ट करता है. इस कार्रवाई का इस्तेमाल किसी कैलेंडर में मौजूदा इवेंट की निजी कॉपी जोड़ने के लिए किया जाता है. सिर्फ़ ऐसे इवेंट इंपोर्ट किए जा सकते हैं जिनका
eventType
default
हो.अब काम न करने वाला तरीका: अगर कोई ऐसा इवेंट इंपोर्ट किया जाता है जो
default
नहीं है, तो उसका टाइपdefault
में बदल दिया जाएगा. साथ ही, उसमें मौजूद इवेंट टाइप से जुड़ी सभी प्रॉपर्टी हटा दी जाएंगी. - डालें
- इवेंट बनाता है.
- इंस्टेंस
- बार-बार होने वाले किसी इवेंट के इंस्टेंस दिखाता है.
- list
- यह फ़ंक्शन, बताए गए कैलेंडर पर मौजूद इवेंट दिखाता है.
- move
- किसी इवेंट को दूसरे कैलेंडर में ले जाता है, जैसे कि किसी इवेंट का आयोजक बदल देता है. ध्यान दें कि सिर्फ़
default
इवेंट को दूसरी जगह ले जाया जा सकता है.birthday
,focusTime
,fromGmail
,outOfOffice
, औरworkingLocation
इवेंट को दूसरी जगह नहीं ले जाया जा सकता. - पैच
- किसी इवेंट को अपडेट करता है. यह तरीका, पैच सेमेंटेक्स के साथ काम करता है. ध्यान दें कि हर पैच अनुरोध के लिए, तीन कोटा यूनिट का इस्तेमाल किया जाता है. इसलिए,
get
के बादupdate
का इस्तेमाल करें. आपने जो फ़ील्ड वैल्यू दी हैं वे मौजूदा वैल्यू की जगह ले लेंगी. अनुरोध में जिन फ़ील्ड की जानकारी नहीं दी जाती है उनमें कोई बदलाव नहीं होता. अगर ऐरे फ़ील्ड तय किए गए हैं, तो वे मौजूदा ऐरे को ओवरराइट कर देते हैं. इससे, पिछले सभी ऐरे एलिमेंट हट जाते हैं. - quickAdd
- यह किसी टेक्स्ट स्ट्रिंग के आधार पर इवेंट बनाता है.
- अपडेट करें
- किसी इवेंट को अपडेट करता है. यह तरीका, पैच सेमेंटेक्स के साथ काम नहीं करता और हमेशा पूरे इवेंट रिसॉर्स को अपडेट करता है. कुछ हद तक अपडेट करने के लिए,
get
के बादupdate
लागू करें. ऐसा करने के लिए, एलिमेंट के एलिमेंट को बेहतर बनाने में मदद मिलती है. - स्मार्टवॉच
- इवेंट के संसाधनों में होने वाले बदलावों पर नज़र रखें.