कैलेंडर 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": { "homeOffice": (value), "customLocation": { "label": string }, "officeLocation": { "buildingId": string, "floorId": string, "floorSectionId": string, "deskId": string, "label": string } }, "attachments": [ { "fileUrl": string, "title": string, "mimeType": string, "iconLink": string, "fileId": string } ], "eventType": string }
प्रॉपर्टी का नाम | वैल्यू | जानकारी | नोट |
---|---|---|---|
anyoneCanAddSelf |
boolean |
इवेंट में किसी को भी न्योता दिया जा सकता है या नहीं (अब यह सुविधा बंद है). ज़रूरी नहीं. डिफ़ॉल्ट रूप से, 'गलत है' पर क्लिक किया जाता है. | लिखा जा सकता है |
attachments[] |
list |
इवेंट के लिए फ़ाइल अटैचमेंट. अटैचमेंट में बदलाव करने के लिए, हर इवेंट में ज़्यादा से ज़्यादा 25 अटैचमेंट हो सकते हैं, |
|
attachments[].fileId |
string |
अटैच की गई फ़ाइल का आईडी. रीड-ओनली. Google Drive में मौजूद फ़ाइलों के लिए, यह आईडी आईडी |
|
attachments[].fileUrl |
string |
अटैचमेंट का यूआरएल लिंक. Google Drive में मौजूद फ़ाइल के अटैचमेंट जोड़ने के लिए, Drive एपीआई में मौजूद अटैचमेंट जोड़ते समय ज़रूरी है. |
लिखा जा सकता है |
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 |
यह एंट्री उस कैलेंडर को दिखाती है जिसमें इवेंट की यह कॉपी दिखती है. रीड-ओनली. डिफ़ॉल्ट रूप से, 'गलत है' पर क्लिक किया जाता है. | |
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 |
समय क्षेत्र जिसमें समय बताया गया है. (IANA समय क्षेत्र डेटाबेस नाम, जैसे "यूरोप/ज़्यूरिख" के रूप में फ़ॉर्मैट किया गया.) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी होता है. साथ ही, यह उस टाइम ज़ोन के बारे में भी बताता है जिसमें दोहराए जाने वाले इवेंट को बढ़ाया जाता है. यह इवेंट वैकल्पिक है और इवेंट के शुरू/खत्म होने के लिए कस्टम समय क्षेत्र दिखाता है. | लिखा जा सकता है |
endTimeUnspecified |
boolean |
खत्म होने के समय की जानकारी नहीं दी गई है. कंपैटबिलिटी की वजहों से, खत्म होने का समय अब भी दिया जाता है, भले ही इस एट्रिब्यूट को 'सही है' पर सेट किया गया हो. डिफ़ॉल्ट रूप से, 'गलत है' पर क्लिक किया जाता है. | |
etag |
etag |
संसाधन का ईटैग. | |
eventType |
string |
इवेंट का खास टाइप. रीड-ओनली. वैल्यू इस तरह की हो सकती हैं:
|
|
extendedProperties |
object |
इवेंट की बढ़ाई गई प्रॉपर्टी. | |
extendedProperties.private |
object |
ऐसी प्रॉपर्टी जो इस कैलेंडर पर दिखने वाले इवेंट की कॉपी के साथ निजी होती हैं. | लिखा जा सकता है |
extendedProperties.private.(key) |
string |
निजी प्रॉपर्टी का नाम और उससे जुड़ी वैल्यू. | |
extendedProperties.shared |
object |
ऐसी प्रॉपर्टी जिन्हें मेहमानों के कैलेंडर पर, इवेंट की कॉपी के बीच शेयर किया जाता है. | लिखा जा सकता है |
extendedProperties.shared.(key) |
string |
शेयर की गई प्रॉपर्टी का नाम और उससे जुड़ी वैल्यू. | |
gadget |
object |
इस इवेंट की अवधि बढ़ाने वाला गैजेट. गैजेट बहिष्कृत कर दिए गए हैं; इसकी बजाय इस संरचना का उपयोग केवल जन्मदिन कैलेंडर कैलेंडर लौटने के लिए किया जाता है. | |
gadget.display |
string |
गैजेट का प्रदर्शन मोड. समर्थन नहीं होना या रुकना. वैल्यू इस तरह की हो सकती हैं:
|
लिखा जा सकता है |
gadget.height |
integer |
गैजेट की ऊंचाई पिक्सल में. ऊंचाई 0 से ज़्यादा होना चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.iconLink |
string |
गैजेट के आइकॉन का यूआरएल. यूआरएल स्कीम एचटीटीपीएस होनी चाहिए. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.link |
string |
गैजेट का URL. यूआरएल स्कीम एचटीटीपीएस होनी चाहिए. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.preferences |
object |
प्राथमिकताएं पर टैप करें. | लिखा जा सकता है |
gadget.preferences.(key) |
string |
प्राथमिकता का नाम और उससे जुड़ी वैल्यू. | |
gadget.title |
string |
गैजेट का शीर्षक. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.type |
string |
गैजेट का प्रकार. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.width |
integer |
गैजेट की चौड़ाई पिक्सल में. चौड़ाई 0 से बड़ी कोई पूर्णांक संख्या होनी चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
guestsCanInviteOthers |
boolean |
आयोजक के अलावा, इवेंट में शामिल होने वाले अन्य लोगों को भी न्योता भेजा जा सकता है या नहीं. ज़रूरी नहीं. डिफ़ॉल्ट वैल्यू 'सही है' है. | लिखा जा सकता है |
guestsCanModify |
boolean |
आयोजक के अलावा, इवेंट में शामिल होने वाले अन्य लोग भी इसमें बदलाव कर सकते हैं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, 'गलत है' पर क्लिक किया जाता है. | लिखा जा सकता है |
guestsCanSeeOtherGuests |
boolean |
इवेंट के आयोजक के अलावा, कोई दूसरा व्यक्ति यह देख सकता है कि इवेंट में शामिल होने वाले लोग कौन हैं. ज़रूरी नहीं. डिफ़ॉल्ट वैल्यू 'सही है' है. | लिखा जा सकता है |
hangoutLink |
string |
इस इवेंट से जुड़े Google Hangout का एक पूरा लिंक. रीड-ओनली. | |
htmlLink |
string |
Google Calendar के वेब यूज़र इंटरफ़ेस (यूआई) में इस इवेंट का पूरा लिंक. रीड-ओनली. | |
iCalUID |
string |
आरएफ़सी5545 में बताए गए तरीके से, इवेंट का यूनीक आइडेंटिफ़ायर. इसका इस्तेमाल, कैलेंडर सिस्टम में इवेंट की पहचान करने के लिए किया जाता है. साथ ही, इवेंट को इंपोर्ट करने के तरीके से इंपोर्ट करना ज़रूरी है. ध्यान दें कि |
|
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 |
समय क्षेत्र जिसमें समय बताया गया है. (IANA समय क्षेत्र डेटाबेस नाम, जैसे "यूरोप/ज़्यूरिख" के रूप में फ़ॉर्मैट किया गया.) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी होता है. साथ ही, यह उस टाइम ज़ोन के बारे में भी बताता है जिसमें दोहराए जाने वाले इवेंट को बढ़ाया जाता है. यह इवेंट वैकल्पिक है और इवेंट के शुरू/खत्म होने के लिए कस्टम समय क्षेत्र दिखाता है. | लिखा जा सकता है |
privateCopy |
boolean |
अगर इस नीति को 'सही है' पर सेट किया जाता है, तो इवेंट का प्रमोशन बंद रहता है. ध्यान दें कि यह निजी इवेंट प्रॉपर्टी से अलग है. ज़रूरी नहीं. नहीं बदले जा सकते. डिफ़ॉल्ट रूप से, 'गलत है' पर क्लिक किया जाता है. | |
recurrence[] |
list |
आरएफ़सी5545 में बताए गए किसी बार-बार होने वाले इवेंट के लिए Rनियमों, EXREQUEST, RDATE, और EXDATE लाइनों की सूची. ध्यान दें कि इस फ़ील्ड में DTSTART और DTEND लाइनों की अनुमति नहीं है. इवेंट के शुरू और खत्म होने के समय start और end फ़ील्ड में दिए जाते हैं. यह फ़ील्ड किसी एक इवेंट या बार-बार होने वाले इवेंट के उदाहरणों के लिए छोड़ दिया जाता है. |
लिखा जा सकता है |
recurringEventId |
string |
किसी बार-बार होने वाले इवेंट के उदाहरण के लिए, यह बार-बार होने वाले इवेंट का id है. नहीं बदले जा सकते. |
|
reminders |
object |
पुष्टि किए गए उपयोगकर्ता के लिए, इवेंट के रिमाइंडर के बारे में जानकारी. | |
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 |
समय क्षेत्र जिसमें समय बताया गया है. (IANA समय क्षेत्र डेटाबेस नाम, जैसे "यूरोप/ज़्यूरिख" के रूप में फ़ॉर्मैट किया गया.) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी होता है. साथ ही, यह उस टाइम ज़ोन के बारे में भी बताता है जिसमें दोहराए जाने वाले इवेंट को बढ़ाया जाता है. यह इवेंट वैकल्पिक है और इवेंट के शुरू/खत्म होने के लिए कस्टम समय क्षेत्र दिखाता है. | लिखा जा सकता है |
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 |
ज़्यादा जानकारी के लिए, एक वैकल्पिक लेबल. |
तरीके
- मिटाएं
- इवेंट को मिटा देती है.
- get
- किसी इवेंट को उसके Google Calendar आईडी के आधार पर दिखाता है. किसी इवेंट को उसके iCalendar आईडी का इस्तेमाल करके फिर से पाने के लिए,
iCalUID
पैरामीटर का इस्तेमाल करके events.list तरीका कॉल करें. - इंपोर्ट करें
- कोई इवेंट आयात करता है. इस कार्रवाई का इस्तेमाल किसी मौजूदा इवेंट की एक निजी कॉपी को किसी कैलेंडर में जोड़ने के लिए किया जाता है.
- शामिल करें
- इवेंट बनाता है.
- इंस्टेंस
- तय किए गए बार-बार होने वाले इवेंट के इंस्टेंस दिखाता है.
- list
- खास कैलेंडर पर इवेंट दिखाता है.
- ले जाएं
- किसी इवेंट को दूसरे कैलेंडर पर ले जाता है, यानी किसी इवेंट के आयोजक को बदलता है.
- पैच
- इवेंट अपडेट करता है. यह तरीका, पैच सिमैंटिक के साथ काम करता है. ध्यान दें कि हर पैच के अनुरोध के लिए, कोटा की तीन इकाइयों का इस्तेमाल किया जाता है. इसके बाद,
get
के बादupdate
का इस्तेमाल किया जाना चाहिए. आप जिन फ़ील्ड मानों को तय करते हैं, वे मौजूदा मानों को बदल देते हैं. आपके अनुरोध में जिन फ़ील्ड की जानकारी नहीं दी जाती है उनमें कोई बदलाव नहीं होता है. अरे फ़ील्ड, अगर बताया गया हो, तो मौजूदा श्रेणियों को ओवरराइट कर दें; इससे पिछले श्रेणी के एलिमेंट खारिज हो जाएंगे. - QuickAdd
- किसी आसान टेक्स्ट स्ट्रिंग पर आधारित इवेंट बनाता है.
- अपडेट
- इवेंट अपडेट करता है. यह तरीका, पैच सिमेंटिक के साथ काम नहीं करता और पूरे इवेंट रिसॉर्स को हमेशा अपडेट करता है. आंशिक रूप से अपडेट करने के लिए,
get
के बादupdate
का इस्तेमाल करें, ताकि एटॉमिकिटी का पता लगाने के लिए ईटैग का इस्तेमाल किया जा सके. - देखें
- इवेंट के संसाधनों में हुए बदलावों का पता लगाएं.