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 } ], "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 |
क्या यह एंट्री उस कैलेंडर को दिखाती है जिस पर इवेंट की यह कॉपी दिखती है. सिर्फ़ पढ़ने के लिए. डिफ़ॉल्ट वैल्यू 'गलत' पर सेट होती है. | |
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 |
संसाधन का 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 |
पिक्सल में गैजेट की ऊंचाई. ऊंचाई 0 से बड़ा कोई पूर्णांक होना चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.iconLink |
string |
गैजेट के आइकॉन का यूआरएल. यूआरएल स्कीम एचटीटीपीएस होनी चाहिए. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
gadget.link |
string |
गैजेट का यूआरएल. यूआरएल स्कीम एचटीटीपीएस होनी चाहिए. समर्थन नहीं होना या रुकना. | लिखा जा सकता है |
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 |
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 |
वह टाइम ज़ोन जिसमें समय बताया गया है. (IANA टाइम ज़ोन डेटाबेस के नाम के तौर पर फ़ॉर्मैट किया गया, जैसे कि "यूरोप/ज़्यूरिख".) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी है. साथ ही, यह उस टाइम ज़ोन के बारे में बताता है जिसमें बार-बार होने वाले इवेंट को बढ़ाया जाता है. किसी एक इवेंट के लिए, यह फ़ील्ड ज़रूरी नहीं है. साथ ही, यह इवेंट के शुरू/खत्म होने के लिए पसंद के मुताबिक बनाए गए टाइम ज़ोन को दिखाता है. | लिखा जा सकता है |
outOfOfficeProperties |
nested object |
'अभी मैं छुट्टी पर हूं' इवेंट का डेटा. अगर eventType outOfOffice हो, तो इसका इस्तेमाल किया जाता है. |
लिखा जा सकता है |
outOfOfficeProperties.autoDeclineMode |
string |
'अभी मैं छुट्टी पर हूं' इवेंट को ओवरलैप करने वाले मीटिंग के न्योतों को अस्वीकार करना है या नहीं. मान्य वैल्यू declineNone होती हैं. इसका मतलब है कि मीटिंग का कोई भी न्योता अस्वीकार नहीं किया जाता; declineAllConflictingInvitations का मतलब है कि मीटिंग के ऐसे सभी न्योते अस्वीकार कर दिए जाएंगे जो इवेंट से मेल नहीं खाते. declineOnlyNewConflictingInvitations का मतलब है कि जब मीटिंग के लिए कोई नया न्योता मिला हो, तो उस न्योते को अस्वीकार कर दिया जाएगा. |
|
outOfOfficeProperties.declineMessage |
string |
अगर Calendar, किसी मौजूदा इवेंट या नए न्योते को अपने-आप अस्वीकार कर देता है, तो जवाब में दिया गया मैसेज सेट करें. | |
privateCopy |
boolean |
अगर यह नीति 'सही है' पर सेट है, तो इवेंट को लागू करना बंद कर दिया जाता है. ध्यान दें कि यह निजी इवेंट प्रॉपर्टी की तरह नहीं होता. ज़रूरी नहीं. इम्यूटेबल. डिफ़ॉल्ट वैल्यू 'गलत' पर सेट होती है. | |
recurrence[] |
list |
बार-बार होने वाले इवेंट के लिए RTERMS, EXTerms, RDATE, और EXDATE लाइनों की सूची. इसके बारे में RFC5545 में बताया गया है. ध्यान दें कि इस फ़ील्ड में DTSTART और DTEND लाइनों की अनुमति नहीं है. इवेंट के शुरू और खत्म होने के समय की जानकारी, start और end फ़ील्ड में दी गई है. यह फ़ील्ड किसी एक इवेंट या बार-बार होने वाले इवेंट के लिए इस्तेमाल नहीं किया जाता है. |
लिखा जा सकता है |
recurringEventId |
string |
किसी बार-बार होने वाले इवेंट के लिए, यह बार-बार होने वाले उस इवेंट का id है जिससे यह इंस्टेंस जुड़ा है. इम्यूटेबल. |
|
reminders |
object |
पुष्टि किए गए उपयोगकर्ता के लिए इवेंट के रिमाइंडर के बारे में जानकारी. | |
reminders.overrides[] |
list |
अगर इवेंट में डिफ़ॉल्ट रिमाइंडर का इस्तेमाल नहीं किया जाता है, तो यह इवेंट के लिए खास रिमाइंडर की सूची बनाता है. अगर सेट नहीं किया गया है, तो यह बताता है कि इस इवेंट के लिए कोई रिमाइंडर सेट नहीं किया गया है. बदलाव करने के लिए, ज़्यादा से ज़्यादा पांच रिमाइंडर इस्तेमाल किए जा सकते हैं. | लिखा जा सकता है |
reminders.overrides[].method |
string |
इस रिमाइंडर के लिए इस्तेमाल किया गया तरीका. संभावित वैल्यू ये हैं:
रिमाइंडर जोड़ते समय ज़रूरी है. |
लिखा जा सकता है |
reminders.overrides[].minutes |
integer |
इवेंट शुरू होने से पहले के मिनट में, रिमाइंडर कब ट्रिगर होना चाहिए. मान्य वैल्यू 0 और 40320 के बीच की होती हैं (मिनट में 4 हफ़्ते). रिमाइंडर जोड़ते समय ज़रूरी है. |
लिखा जा सकता है |
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 |
ऑफ़िस का वह नाम जो Calendar के वेब और मोबाइल क्लाइंट में दिखता है. हमारा सुझाव है कि आप संगठन के संसाधन डेटाबेस में बिल्डिंग का नाम बताएं. | लिखा जा सकता है |
workingLocationProperties.type |
string |
काम करने की जगह किस तरह की है. संभावित वैल्यू ये हैं:
काम करने की जगह वाली प्रॉपर्टी जोड़ते समय ज़रूरी है. |
लिखा जा सकता है |
तरीके
- मिटाएं
- इवेंट को मिटाता है.
- get
- Google Calendar आईडी के आधार पर इवेंट दिखाता है. किसी इवेंट को उसके iCalendar आईडी का इस्तेमाल करके वापस पाने के लिए,
iCalUID
पैरामीटर का इस्तेमाल करके event.list तरीके को कॉल करें. - import
- कोई इवेंट इंपोर्ट करता है. इस कार्रवाई का इस्तेमाल, किसी मौजूदा इवेंट की निजी कॉपी को कैलेंडर में जोड़ने के लिए किया जाता है. सिर्फ़
default
केeventType
वाले इवेंट इंपोर्ट किए जा सकते हैं.अब काम नहीं करने वाला व्यवहार: अगर कोई ऐसा इवेंट इंपोर्ट किया जाता है जो
default
नहीं है, तो उसका टाइप बदलकरdefault
कर दिया जाएगा. साथ ही, इवेंट टाइप के आधार पर बनी उस प्रॉपर्टी को हटा दिया जाएगा. - डालें
- कोई इवेंट बनाता है.
- इंस्टेंस
- बार-बार होने वाले तय इवेंट के इंस्टेंस दिखाता है.
- list
- खास कैलेंडर पर इवेंट दिखाता है.
- ले जाएं
- किसी इवेंट को दूसरे कैलेंडर में ले जाता है, जैसे कि किसी इवेंट का आयोजक बदल जाता है. ध्यान दें कि सिर्फ़
default
इवेंट को दूसरी जगह ले जाया जा सकता है;outOfOffice
,focusTime
,workingLocation
, औरfromGmail
इवेंट को दूसरी जगह नहीं ले जाया जा सकता. - पैच
- किसी इवेंट को अपडेट करती है. यह तरीका पैच सिमैंटिक के साथ काम करता है. ध्यान दें कि हर पैच के लिए अनुरोध करने पर, तीन कोटा यूनिट का इस्तेमाल होता है.
get
के बादupdate
का इस्तेमाल करें. आपकी ओर से तय की गई फ़ील्ड वैल्यू, मौजूदा वैल्यू को बदल देती हैं. आपने जिन फ़ील्ड को अनुरोध में नहीं डाला है उनमें कोई बदलाव नहीं होगा. अरे फ़ील्ड, अगर उनके बारे में बताया गया है, तो वे मौजूदा अरे को ओवरराइट कर देते हैं; इसमें पहले के किसी ऐरे एलिमेंट को खारिज कर दिया जाता है. - quickAdd
- सिंपल टेक्स्ट स्ट्रिंग पर आधारित इवेंट बनाता है.
- अपडेट
- किसी इवेंट को अपडेट करती है. इस तरीके से, पैच सिमैंटिक इस्तेमाल नहीं किया जा सकता. साथ ही, इवेंट के पूरे रिसॉर्स को हमेशा अपडेट किया जाता है. कुछ हद तक अपडेट करने के लिए,
get
का इस्तेमाल करें. इसके बाद, ई-टैग का इस्तेमाल करकेupdate
को जोड़ें. इससे यह पक्का किया जा सकेगा कि दोनों में से कोई एक शर्त पूरी नहीं की गई है. - देखें
- इवेंट से जुड़े संसाधनों में हुए बदलावों के बारे में जानें.