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 |
एंट्री पॉइंट का यूआरआई. ज़्यादा से ज़्यादा 1300 वर्ण हो सकते हैं. फ़ॉर्मैट:
|
|
conferenceData.notes |
string |
उपयोगकर्ता को दिखाने के लिए अतिरिक्त जानकारी, जैसे कि डोमेन एडमिन से मिले निर्देश, कानूनी नोटिस. इसमें एचटीएमएल हो सकता है. ज़्यादा से ज़्यादा 2,048 वर्ण इस्तेमाल किए जा सकते हैं. ज़रूरी नहीं. | |
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 |
खास तरह का इवेंट. इवेंट बनाने के बाद, इसमें बदलाव नहीं किया जा सकता. आपको ये वैल्यू दिख सकती हैं:
default " और "workingLocation " इवेंट बनाए जा सकते हैं. अन्य इवेंट टाइप के लिए अतिरिक्त सहायता, बाद की रिलीज़ में उपलब्ध कराई जाएगी. |
लिखने योग्य |
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 |
RFC5545 में दी गई जानकारी के हिसाब से, बार-बार होने वाले इवेंट के लिए RRT, EX खान, 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 |
ऑफ़िस का वह नाम जो Calendar के वेब और मोबाइल क्लाइंट में दिखता है. हमारा सुझाव है कि आप संगठन के संसाधन डेटाबेस में इमारत का नाम बताएं. | लिखने योग्य |
workingLocationProperties.type |
string |
काम करने की जगह किस तरह की है. आपको ये वैल्यू दिख सकती हैं:
काम करने की जगह वाली प्रॉपर्टी जोड़ने के लिए ज़रूरी है. |
लिखने योग्य |
तरीके
- मिटाएं
- एक इवेंट हटाता है.
- पाएं
- अपने 'Google कैलेंडर' आईडी के आधार पर इवेंट लौटाता है. किसी इवेंट के iCalendar आईडी का इस्तेमाल करके उसे वापस पाने के लिए,
iCalUID
पैरामीटर का इस्तेमाल करके,events.list तरीके को कॉल करें. - import
- एक इवेंट आयात करता है. इस कार्रवाई का इस्तेमाल किसी मौजूदा इवेंट की निजी कॉपी को कैलेंडर में जोड़ने के लिए किया जाता है.
- शामिल करें
- इवेंट बनाता है.
- इंस्टेंस
- खास बार-बार होने वाले इवेंट के इंस्टेंस दिखाता है.
- list
- खास कैलेंडर पर इवेंट दिखाता है.
- ले जाएं
- किसी इवेंट को दूसरे कैलेंडर में ले जाता है, जैसे कि इवेंट का आयोजक बदल देता है. ध्यान दें कि सिर्फ़
default
इवेंट को दूसरी जगह ले जाया जा सकता है,outOfOffice
,focusTime
, औरworkingLocation
इवेंट को दूसरी जगह नहीं ले जाया जा सकता. - पैच
- इवेंट को अपडेट करता है. यह विधि पैच सिमैंटिक का समर्थन करती है. ध्यान दें कि हर पैच के लिए अनुरोध करने पर, तीन कोटा यूनिट का इस्तेमाल होता है. ज़्यादा से ज़्यादा
get
के बादupdate
का इस्तेमाल किया जाता है. आपकी तय की गई फ़ील्ड वैल्यू, मौजूदा वैल्यू को बदल देती हैं. आपने जो फ़ील्ड अनुरोध में नहीं दिए हैं उनमें कोई बदलाव नहीं होगा. अरे फ़ील्ड बताए जाने पर, मौजूदा अरे को ओवरराइट कर देते हैं. ऐसा करने पर, पहले से मौजूद अरे एलिमेंट खारिज हो जाते हैं. - quickAdd
- सिंपल टेक्स्ट स्ट्रिंग के आधार पर इवेंट बनाता है.
- अपडेट करें
- इवेंट को अपडेट करता है. यह तरीका पैच सिमैंटिक के साथ काम नहीं करता और हमेशा इवेंट के पूरे संसाधन को अपडेट करता है. कुछ हिस्से का अपडेट करने के लिए,
get
और उसके बादupdate
करें. ऐसा करने के लिए, ईटैग का इस्तेमाल करें, ताकि यह पक्का किया जा सके कि ऑब्जेक्ट में कोई गड़बड़ी न हो. - देखें
- इवेंट से जुड़े संसाधनों में हुए बदलावों के बारे में जानें.