Events

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 इवेंट के फ़ाइल अटैचमेंट.

अटैचमेंट में बदलाव करने के लिए, supportsAttachments अनुरोध पैरामीटर को true पर सेट किया जाना चाहिए.

हर इवेंट में ज़्यादा से ज़्यादा 25 अटैचमेंट हो सकते हैं.

attachments[].fileId string अटैच की गई फ़ाइल का आईडी. सिर्फ़ पढ़ने के लिए.

Google Drive फ़ाइलों के लिए, यह Drive API में Files संसाधन एंट्री का आईडी है.

attachments[].fileUrl string अटैचमेंट का यूआरएल लिंक.

Google Drive में मौजूद फ़ाइलों के अटैचमेंट जोड़ने के लिए, उसी फ़ॉर्मैट का इस्तेमाल करें जो Drive API में Files संसाधन की alternateLink प्रॉपर्टी में दिया गया है.

अटैचमेंट जोड़ते समय ज़रूरी है.

लिखने योग्य
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 मेहमान के जवाब की स्थिति. आपको ये वैल्यू दिख सकती हैं:
  • "needsAction" - मेहमान ने न्योते का जवाब नहीं दिया है (नए इवेंट के लिए सुझाया गया).
  • "declined" - मेहमान ने न्योता अस्वीकार कर दिया है.
  • "tentative" - मेहमान ने फ़िलहाल न्योता स्वीकार कर लिया है.
  • "accepted" - मेहमान ने न्योता स्वीकार कर लिया है.
लिखने योग्य
attendees[].self boolean क्या यह एंट्री उस कैलेंडर का प्रतिनिधित्व करती है जिस पर इवेंट की यह कॉपी दिखती है. सिर्फ़ पढ़ने के लिए. डिफ़ॉल्ट रूप से यह वैल्यू 'गलत' पर सेट होती है.
colorId string इवेंट का रंग. यह आईडी, कलर की परिभाषा के event सेक्शन में मौजूद एंट्री के बारे में बताता है. इसके लिए, कलर का एंडपॉइंट देखें. ज़रूरी नहीं. लिखने योग्य
conferenceData nested object कॉन्फ़्रेंस से जुड़ी जानकारी, जैसे कि Google Meet कॉन्फ़्रेंस का ब्यौरा. नई कॉन्फ़्रेंस की जानकारी बनाने के लिए, createRequest फ़ील्ड का इस्तेमाल करें. अगर आपको बदलाव बनाए रखने हैं, तो इवेंट में बदलाव के सभी अनुरोधों के लिए, conferenceDataVersion अनुरोध पैरामीटर को 1 पर सेट करना न भूलें. लिखने योग्य
conferenceData.conferenceId string कॉन्फ़्रेंस का आईडी.

इसका इस्तेमाल डेवलपर, कॉन्फ़्रेंस पर नज़र रखने के लिए कर सकते हैं. इसलिए, इस जानकारी को उपयोगकर्ताओं को नहीं दिखाना चाहिए.

हर तरह के कॉन्फ़्रेंस समाधान के लिए, आईडी की वैल्यू अलग-अलग बनाई जाती है:

  • eventHangout: आईडी सेट नहीं है. (यह कॉन्फ़्रेंस टाइप अब सेवा में नहीं है.)
  • eventNamedHangout: आईडी, Hangout का नाम है. (यह कॉन्फ़्रेंस टाइप अब सेवा में नहीं है.)
  • hangoutsMeet: आईडी 10 अक्षरों वाला मीटिंग कोड होता है, जैसे कि aaa-bbbb-ccc.
  • addOn: आईडी, सेवा देने वाली तीसरे पक्ष की कंपनी तय करती है.
ज़रूरी नहीं.

conferenceData.conferenceSolution nested object कॉन्फ़्रेंस सलूशन, जैसे कि Google Meet.

बनाने का अनुरोध नहीं करने की वजह से, कॉन्फ़्रेंस के लिए इस सेटिंग को अनसेट किया गया.

conferenceSolution और कम से कम एक entryPoint या createRequest की ज़रूरत है.

conferenceData.conferenceSolution.iconUri string इस सलूशन के लिए उपयोगकर्ता को दिखने वाला आइकॉन.
conferenceData.conferenceSolution.key nested object वह कुंजी जो इस इवेंट के लिए कॉन्फ़्रेंस सलूशन की पहचान कर सकती है.
conferenceData.conferenceSolution.key.type string कॉन्फ़्रेंस सलूशन का टाइप.

अगर क्लाइंट को कोई अनजान या खाली टाइप दिखता है, तब भी वह एंट्री पॉइंट दिखा सकता है. हालांकि, इसमें बदलाव करने की अनुमति नहीं होनी चाहिए.

आपको ये वैल्यू दिख सकती हैं:

  • उपभोक्ताओं के लिए Hangouts के लिए "eventHangout" (अब सेवा में नहीं है; मौजूदा इवेंट में यह कॉन्फ़्रेंस समाधान का टाइप दिख सकता है, लेकिन नई कॉन्फ़्रेंस नहीं बनाई जा सकती)
  • Google Workspace के उपयोगकर्ताओं के लिए Hangouts के क्लासिक वर्शन के लिए "eventNamedHangout" (अब सेवा में नहीं है. मौजूदा इवेंट में, इस तरह का कॉन्फ़्रेंस दिख सकता है, लेकिन नई कॉन्फ़्रेंस नहीं बनाई जा सकती)
  • Google Meet के लिए "hangoutsMeet" (http://meet.google.com)
  • 3P (तीसरे पक्ष) कॉन्फ़्रेंस की सेवा देने वाली कंपनियों के लिए "addOn"

conferenceData.conferenceSolution.name string इस सलूशन का नाम जो उपयोगकर्ता को दिखता है. स्थानीय भाषा में नहीं बनाया गया है.
conferenceData.createRequest nested object नई कॉन्फ़्रेंस जनरेट करने और उसे इवेंट में अटैच करने का अनुरोध. डेटा, एसिंक्रोनस तरीके से जनरेट होता है. यह देखने के लिए कि डेटा मौजूद है या नहीं, status फ़ील्ड देखें.

conferenceSolution और कम से कम एक entryPoint या createRequest की ज़रूरत है.

conferenceData.createRequest.conferenceSolutionKey nested object कॉन्फ़्रेंस सेवाएं, जैसे कि Hangouts या Google Meet.
conferenceData.createRequest.conferenceSolutionKey.type string कॉन्फ़्रेंस सलूशन का टाइप.

अगर क्लाइंट को कोई अनजान या खाली टाइप दिखता है, तब भी वह एंट्री पॉइंट दिखा सकता है. हालांकि, इसमें बदलाव करने की अनुमति नहीं होनी चाहिए.

आपको ये वैल्यू दिख सकती हैं:

  • उपभोक्ताओं के लिए Hangouts के लिए "eventHangout" (अब सेवा में नहीं है; मौजूदा इवेंट में यह कॉन्फ़्रेंस समाधान का टाइप दिख सकता है, लेकिन नई कॉन्फ़्रेंस नहीं बनाई जा सकती)
  • Google Workspace के उपयोगकर्ताओं के लिए Hangouts के क्लासिक वर्शन के लिए "eventNamedHangout" (अब सेवा में नहीं है. मौजूदा इवेंट में, इस तरह का कॉन्फ़्रेंस दिख सकता है, लेकिन नई कॉन्फ़्रेंस नहीं बनाई जा सकती)
  • Google Meet के लिए "hangoutsMeet" (http://meet.google.com)
  • 3P (तीसरे पक्ष) कॉन्फ़्रेंस की सेवा देने वाली कंपनियों के लिए "addOn"

conferenceData.createRequest.requestId string इस अनुरोध के लिए क्लाइंट का जनरेट किया गया यूनीक आईडी.

क्लाइंट को हर नए अनुरोध के लिए, यह आईडी फिर से जनरेट करना होगा. अगर कोई आईडी, पिछले अनुरोध में दिए गए आईडी से मेल खाता है, तो अनुरोध को अनदेखा कर दिया जाता है.

conferenceData.createRequest.status nested object कॉन्फ़्रेंस बनाने के अनुरोध की स्थिति.
conferenceData.createRequest.status.statusCode string कॉन्फ़्रेंस बनाने के अनुरोध की मौजूदा स्थिति. सिर्फ़ पढ़ने के लिए.

आपको ये वैल्यू दिख सकती हैं:

  • "pending": कॉन्फ़्रेंस बनाने का अनुरोध अब भी प्रोसेस किया जा रहा है.
  • "success": कॉन्फ़्रेंस बनाने का अनुरोध पूरा हो गया है, एंट्री पॉइंट अपने-आप भर गए हैं.
  • "failure": कॉन्फ़्रेंस बनाने का अनुरोध पूरा नहीं हो सका, कोई एंट्री पॉइंट नहीं है.

conferenceData.entryPoints[] list किसी कॉन्फ़्रेंस के एंट्री पॉइंट के बारे में जानकारी, जैसे कि यूआरएल या फ़ोन नंबर.

वे सभी एक ही कॉन्फ़्रेंस से जुड़े होने चाहिए.

conferenceSolution और कम से कम एक entryPoint या createRequest की ज़रूरत है.

conferenceData.entryPoints[].accessCode string कॉन्फ़्रेंस को ऐक्सेस करने के लिए ऐक्सेस कोड. ज़्यादा से ज़्यादा 128 वर्ण हाेने चाहिए.

नया कॉन्फ़्रेंस डेटा बनाते समय, सिर्फ़ {meetingCode, accessCode, passcode, password, pin} फ़ील्ड के उन सबसेट को पॉप्युलेट करें जो कॉन्फ़्रेंस की सुविधा देने वाली कंपनी की शब्दावली से मेल खाते हों. सिर्फ़ अपने-आप भरे गए फ़ील्ड दिखने चाहिए.

ज़रूरी नहीं.

conferenceData.entryPoints[].entryPointType string कॉन्फ़्रेंस के एंट्री पॉइंट का टाइप.

आपको ये वैल्यू दिख सकती हैं:

  • "video" - एचटीटीपी पर कॉन्फ़्रेंस में शामिल होना. किसी कॉन्फ़्रेंस में एक या एक video एंट्री पॉइंट हो सकता है.
  • "phone" - फ़ोन नंबर डायल करके कॉन्फ़्रेंस में शामिल हो रहे हैं. किसी कॉन्फ़्रेंस में एक या उससे ज़्यादा phone एंट्री पॉइंट हो सकते हैं.
  • "sip" - SIP की मदद से कॉन्फ़्रेंस में शामिल हो रहे हैं. किसी कॉन्फ़्रेंस में एक या एक sip एंट्री पॉइंट हो सकता है.
  • "more" - कॉन्फ़्रेंस में शामिल होने के लिए अन्य निर्देश, जैसे कि अतिरिक्त फ़ोन नंबर. किसी कॉन्फ़्रेंस में एक या एक more एंट्री पॉइंट हो सकता है. सिर्फ़ more एंट्री पॉइंट वाली कॉन्फ़्रेंस, मान्य कॉन्फ़्रेंस नहीं होती.

conferenceData.entryPoints[].label string यूआरआई के लिए लेबल. यह सिर्फ़ असली उपयोगकर्ताओं को दिखेगा. स्थानीय भाषा में नहीं बनाया गया है. ज़्यादा से ज़्यादा 512 वर्ण हो सकते हैं.

उदाहरण:

  • video के लिए: meet.google.com/aaa-bbbb-पर
  • phone के लिए: +1 123 268 2601
  • sip के लिए: 12345678@altostrat.com
  • more के लिए: भरी नहीं जानी चाहिए

ज़रूरी नहीं.

conferenceData.entryPoints[].meetingCode string कॉन्फ़्रेंस को ऐक्सेस करने के लिए मीटिंग कोड. ज़्यादा से ज़्यादा 128 वर्ण हाेने चाहिए.

नया कॉन्फ़्रेंस डेटा बनाते समय, सिर्फ़ {meetingCode, accessCode, passcode, password, pin} फ़ील्ड के उन सबसेट को पॉप्युलेट करें जो कॉन्फ़्रेंस की सुविधा देने वाली कंपनी की शब्दावली से मेल खाते हों. सिर्फ़ अपने-आप भरे गए फ़ील्ड दिखने चाहिए.

ज़रूरी नहीं.

conferenceData.entryPoints[].passcode string कॉन्फ़्रेंस को ऐक्सेस करने के लिए पासवर्ड. ज़्यादा से ज़्यादा 128 वर्ण हाेने चाहिए.

नया कॉन्फ़्रेंस डेटा बनाते समय, सिर्फ़ {meetingCode, accessCode, passcode, password, pin} फ़ील्ड के उन सबसेट को पॉप्युलेट करें जो कॉन्फ़्रेंस की सुविधा देने वाली कंपनी की शब्दावली से मेल खाते हों. सिर्फ़ अपने-आप भरे गए फ़ील्ड दिखने चाहिए.

conferenceData.entryPoints[].password string कॉन्फ़्रेंस को ऐक्सेस करने के लिए पासवर्ड. ज़्यादा से ज़्यादा 128 वर्ण हाेने चाहिए.

नया कॉन्फ़्रेंस डेटा बनाते समय, सिर्फ़ {meetingCode, accessCode, passcode, password, pin} फ़ील्ड के उन सबसेट को पॉप्युलेट करें जो कॉन्फ़्रेंस की सुविधा देने वाली कंपनी की शब्दावली से मेल खाते हों. सिर्फ़ अपने-आप भरे गए फ़ील्ड दिखने चाहिए.

ज़रूरी नहीं.

conferenceData.entryPoints[].pin string कॉन्फ़्रेंस को ऐक्सेस करने के लिए पिन. ज़्यादा से ज़्यादा 128 वर्ण हाेने चाहिए.

नया कॉन्फ़्रेंस डेटा बनाते समय, सिर्फ़ {meetingCode, accessCode, passcode, password, pin} फ़ील्ड के उन सबसेट को पॉप्युलेट करें जो कॉन्फ़्रेंस की सुविधा देने वाली कंपनी की शब्दावली से मेल खाते हों. सिर्फ़ अपने-आप भरे गए फ़ील्ड दिखने चाहिए.

ज़रूरी नहीं.

conferenceData.entryPoints[].uri string एंट्री पॉइंट का यूआरआई. ज़्यादा से ज़्यादा 1300 वर्ण हो सकते हैं.

फ़ॉर्मैट:

  • video के लिए, http: या https: स्कीमा ज़रूरी है.
  • phone के लिए, tel: स्कीमा ज़रूरी है. यूआरआई में डायल का पूरा क्रम (उदाहरण के लिए, टेलीफ़ोन नंबर:+12345678900,,,123456789;1234) शामिल होना चाहिए.
  • sip के लिए, sip: स्कीमा ज़रूरी है. जैसे, sip:12345678@myprovider.com.
  • more के लिए, http: या https: स्कीमा ज़रूरी है.

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" - एक सामान्य इवेंट या आगे बताया नहीं गया है.
  • "outOfOffice" - 'अभी मैं छुट्टी पर हूं' इवेंट. मान्य इवेंट बनाने के लिए, outOfOfficeProperties पैरामीटर दिया जाना चाहिए (भले ही, खाली हो).
  • "focusTime" - फ़ोकस टाइम इवेंट. मान्य इवेंट बनाने के लिए, focusTimeProperties पैरामीटर दिया जाना चाहिए (भले ही, खाली हो).
  • "workingLocation" - काम करने की जगह से जुड़ा इवेंट.
फ़िलहाल, इस एपीआई का इस्तेमाल करके सिर्फ़ "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 गैजेट का प्रदर्शन मोड. समर्थन नहीं होना या रुकना. आपको ये वैल्यू दिख सकती हैं:
  • "icon" - कैलेंडर व्यू में यह गैजेट, इवेंट के टाइटल के बगल में दिखता है.
  • "chip" - इवेंट क्लिक किए जाने पर गैजेट दिखता है.
लिखने योग्य
gadget.height integer पिक्सल में गैजेट की ऊंचाई. ऊंचाई 0 से ज़्यादा कोई पूर्णांक होना चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. लिखने योग्य
gadget.preferences object प्राथमिकताएं पर टैप करें. लिखने योग्य
gadget.preferences.(key) string प्राथमिकता का नाम और उससे जुड़ी वैल्यू.
gadget.title string गैजेट का शीर्षक. समर्थन नहीं होना या रुकना. लिखने योग्य
gadget.type string गैजेट का टाइप. समर्थन नहीं होना या रुकना. लिखने योग्य
gadget.width integer पिक्सल में गैजेट की चौड़ाई. चौड़ाई 0 से ज़्यादा पूर्णांक में होनी चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. लिखने योग्य
guestsCanInviteOthers boolean क्या आयोजक के अलावा, दूसरे लोग भी इवेंट में शामिल होने का न्योता भेज सकते हैं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से यह 'सही' पर सेट होती है. लिखने योग्य
guestsCanModify boolean क्या आयोजक के अलावा अन्य मेहमान इवेंट में बदलाव कर सकते हैं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से यह वैल्यू 'गलत' पर सेट होती है. लिखने योग्य
guestsCanSeeOtherGuests boolean क्या आयोजक के अलावा अन्य मेहमान यह देख सकते हैं कि इवेंट के मेहमान कौन हैं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से यह 'सही' पर सेट होती है. लिखने योग्य
iCalUID string RFC5545 में बताए गए इवेंट का यूनीक आइडेंटिफ़ायर. इसका इस्तेमाल, कैलेंडरिंग सिस्टम में इवेंट की पहचान करने के लिए किया जाता है. साथ ही, import तरीके से इवेंट इंपोर्ट करते समय इसकी ज़रूरत होती है.

ध्यान दें कि iCalUID और id एक जैसे नहीं हैं और इवेंट बनाते समय इनमें से सिर्फ़ एक ही दी जानी चाहिए. इन कीवर्ड के सिमैंटिक में एक अंतर यह है कि बार-बार होने वाले इवेंट में एक ही इवेंट के सभी id अलग-अलग होते हैं, जबकि सभी का iCalUID एक जैसा होता है. किसी इवेंट के iCalUID का इस्तेमाल करके उसे फिर से पाने के लिए, events.list तरीके को कॉल करें. इसके लिए, iCalUID पैरामीटर का इस्तेमाल करें. किसी इवेंट के id का इस्तेमाल करके उसे वापस पाने के लिए, events.get तरीके को कॉल करें.

id string इवेंट का ओपेक आइडेंटिफ़ायर. नए सिंगल या बार-बार होने वाले इवेंट बनाते समय, उनके आईडी तय किए जा सकते हैं. दिए गए आईडी को इन नियमों के मुताबिक होना चाहिए:
  • आईडी में जिन वर्णों का इस्तेमाल किया जा सकता है उन्हें base32hex एन्कोडिंग में इस्तेमाल किया जाता है, जैसे कि अंग्रेज़ी के छोटे अक्षर a-v और 0-9 अंक. RFC2938 में सेक्शन 3.1.2 देखें
  • आईडी की लंबाई 5 से 1024 वर्णों के बीच होनी चाहिए
  • हर कैलेंडर के लिए, आईडी यूनीक होना चाहिए
यह सिस्टम दुनिया भर में डिस्ट्रिब्यूट किया जा रहा है. इसलिए, हम इस बात की गारंटी नहीं दे सकते कि इवेंट बनाते समय आईडी की वजह से होने वाले टकरावों का पता लगाया जाएगा. टकराव के जोखिम को कम करने के लिए, हमारा सुझाव है कि आप पहले से मौजूद यूयूआईडी एल्गोरिदम का इस्तेमाल करें. जैसा कि RFC4122 में बताया गया है.

अगर आप कोई आईडी नहीं देते हैं, तो सर्वर उसे अपने-आप जनरेट कर देगा.

ध्यान दें कि icalUID और id एक जैसे नहीं हैं और इवेंट बनाते समय इनमें से सिर्फ़ एक ही दी जानी चाहिए. इन कीवर्ड के सिमैंटिक में एक अंतर यह है कि बार-बार होने वाले इवेंट में एक ही इवेंट के सभी id अलग-अलग होते हैं, जबकि सभी का icalUID एक जैसा होता है.

लिखने योग्य
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 इस रिमाइंडर में इस्तेमाल किया गया तरीका. आपको ये वैल्यू दिख सकती हैं:
  • "email" - रिमाइंडर, ईमेल से भेजे जाते हैं.
  • "popup" - रिमाइंडर, यूज़र इंटरफ़ेस (यूआई) पॉप-अप के ज़रिए भेजे जाते हैं.

रिमाइंडर जोड़ते समय ज़रूरी है.

लिखने योग्य
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 इवेंट की स्थिति. ज़रूरी नहीं. आपको ये वैल्यू दिख सकती हैं:
  • "confirmed" - इवेंट की पुष्टि हो गई है. यह डिफ़ॉल्ट स्थिति है.
  • "tentative" - इवेंट की संभावित रूप से पुष्टि की गई है.
  • "cancelled" - इवेंट रद्द कर दिया गया है (मिटाया गया). सूची वाला तरीका, रद्द किए गए इवेंट सिर्फ़ तब दिखाता है, जब syncToken या updatedMin दिए गए हों या showDeleted फ़्लैग true पर सेट किया गया हो. ऐसा तब होता है, जब इवेंट को सिंक करने के दौरान लगातार होने वाले सिंक की वजह से रद्द किया जाता है. get तरीके से ये नतीजे मिलते हैं.

    'रद्द की गई' स्थिति, इवेंट के टाइप के आधार पर दो अलग-अलग स्थितियों को दिखाती है:

    1. रद्द नहीं किए गए बार-बार होने वाले इवेंट के रद्द किए गए अपवादों से पता चलता है कि यह इंस्टेंस अब उपयोगकर्ता को नहीं दिखाया जाना चाहिए. क्लाइंट को इन इवेंट को, बार-बार होने वाले पैरंट इवेंट के लाइफ़टाइम में सेव करना चाहिए.

      रद्द किए गए अपवाद सिर्फ़ इस बात की गारंटी हैं कि id, recurringEventId, और originalStartTime फ़ील्ड की वैल्यू अपने-आप भरी हुई होंगी. अन्य फ़ील्ड खाली हो सकते हैं.

    2. रद्द किए गए अन्य सभी इवेंट, मिटाए गए इवेंट की जानकारी देते हैं. क्लाइंट को अपनी स्थानीय रूप से सिंक की गई कॉपी हटानी होंगी. रद्द किए गए ऐसे इवेंट आखिर में हट जाएंगे, इसलिए उन्हें हमेशा के लिए उपलब्ध रहने पर भरोसा न करें.

      सिर्फ़ id फ़ील्ड में ही शामिल होने की गारंटी दी जा सकती है.

    आयोजक के कैलेंडर में, रद्द किए गए इवेंट की जानकारी दिखती रहेगी. जैसे, खास जानकारी, जगह वगैरह, ताकि इवेंट को वापस लाया जा सके (मिटाया नहीं गया है). इसी तरह, जिन इवेंट में उपयोगकर्ता को न्योता भेजा गया था और जिन इवेंट को उन्होंने मैन्युअल तरीके से हटाया था उनकी जानकारी मिलती रहेगी. हालांकि, showDeleted के साथ बढ़ते सिंक के अनुरोधों को 'गलत' पर सेट करने से, यह जानकारी नहीं दिखेगी.

    अगर किसी इवेंट का आयोजक बदल जाता है (उदाहरण के लिए, मूव कार्रवाई से) और असल आयोजक, मेहमानों की सूची में नहीं है, तो रद्द किए गए इवेंट को रद्द कर दिया जाएगा. यहां सिर्फ़ id फ़ील्ड के भरे जाने की गारंटी होगी.

लिखने योग्य
summary string इवेंट का शीर्षक. लिखने योग्य
transparency string इवेंट, कैलेंडर पर समय को ब्लॉक करता है या नहीं. ज़रूरी नहीं. आपको ये वैल्यू दिख सकती हैं:
  • "opaque" - डिफ़ॉल्ट वैल्यू. इवेंट की वजह से कैलेंडर पर समय ब्लॉक हो जाता है. यह Calendar के यूज़र इंटरफ़ेस (यूआई) में मुझे व्यस्त पर सेट करने के जैसा है.
  • "transparent" - इवेंट की वजह से कैलेंडर में समय नहीं दिखता है. यह Calendar के यूज़र इंटरफ़ेस (यूआई) में मुझे दिखाएं को उपलब्ध पर सेट करने जैसा है.
लिखने योग्य
updated datetime इवेंट में पिछली बार हुए बदलाव का समय (RFC3339 टाइमस्टैंप के हिसाब से). सिर्फ़ पढ़ने के लिए.
visibility string इवेंट की दृश्यता. ज़रूरी नहीं. आपको ये वैल्यू दिख सकती हैं:
  • "default" - कैलेंडर के इवेंट के लिए, डिफ़ॉल्ट तौर पर दिखने की सेटिंग का इस्तेमाल करता है. यह डिफ़ॉल्ट मान है.
  • "public" - इवेंट सार्वजनिक है और इवेंट की जानकारी कैलेंडर के सभी पाठकों को दिखती है.
  • "private" - यह इवेंट निजी है और सिर्फ़ इवेंट में शामिल लोग ही इसकी जानकारी देख सकते हैं.
  • "confidential" - इवेंट निजी है. यह वैल्यू इस वजह से दी गई है कि यह साथ काम करता है या नहीं.
लिखने योग्य
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 काम करने की जगह किस तरह की है. आपको ये वैल्यू दिख सकती हैं:
  • "homeOffice" - उपयोगकर्ता घर पर काम कर रहा है.
  • "officeLocation" - उपयोगकर्ता किसी ऑफ़िस से काम कर रहा है.
  • "customLocation" - उपयोगकर्ता किसी कस्टम जगह से काम कर रहा है.
कोई भी जानकारी, किसी नाम के सब-फ़ील्ड में दी जाती है. हालांकि, ऐसा हो सकता है कि खाली होने पर यह फ़ील्ड मौजूद न हो. किसी भी दूसरे फ़ील्ड को अनदेखा कर दिया जाता है.

काम करने की जगह वाली प्रॉपर्टी जोड़ने के लिए ज़रूरी है.

लिखने योग्य

तरीके

मिटाएं
एक इवेंट हटाता है.
पाएं
अपने 'Google कैलेंडर' आईडी के आधार पर इवेंट लौटाता है. किसी इवेंट के iCalendar आईडी का इस्तेमाल करके उसे वापस पाने के लिए, iCalUID पैरामीटर का इस्तेमाल करके,events.list तरीके को कॉल करें.
import
एक इवेंट आयात करता है. इस कार्रवाई का इस्तेमाल किसी मौजूदा इवेंट की निजी कॉपी को कैलेंडर में जोड़ने के लिए किया जाता है.
शामिल करें
इवेंट बनाता है.
इंस्टेंस
खास बार-बार होने वाले इवेंट के इंस्टेंस दिखाता है.
list
खास कैलेंडर पर इवेंट दिखाता है.
ले जाएं
किसी इवेंट को दूसरे कैलेंडर में ले जाता है, जैसे कि इवेंट का आयोजक बदल देता है. ध्यान दें कि सिर्फ़ default इवेंट को दूसरी जगह ले जाया जा सकता है, outOfOffice, focusTime, और workingLocation इवेंट को दूसरी जगह नहीं ले जाया जा सकता.
पैच
इवेंट को अपडेट करता है. यह विधि पैच सिमैंटिक का समर्थन करती है. ध्यान दें कि हर पैच के लिए अनुरोध करने पर, तीन कोटा यूनिट का इस्तेमाल होता है. ज़्यादा से ज़्यादा get के बाद update का इस्तेमाल किया जाता है. आपकी तय की गई फ़ील्ड वैल्यू, मौजूदा वैल्यू को बदल देती हैं. आपने जो फ़ील्ड अनुरोध में नहीं दिए हैं उनमें कोई बदलाव नहीं होगा. अरे फ़ील्ड बताए जाने पर, मौजूदा अरे को ओवरराइट कर देते हैं. ऐसा करने पर, पहले से मौजूद अरे एलिमेंट खारिज हो जाते हैं.
quickAdd
सिंपल टेक्स्ट स्ट्रिंग के आधार पर इवेंट बनाता है.
अपडेट करें
इवेंट को अपडेट करता है. यह तरीका पैच सिमैंटिक के साथ काम नहीं करता और हमेशा इवेंट के पूरे संसाधन को अपडेट करता है. कुछ हिस्से का अपडेट करने के लिए, get और उसके बाद update करें. ऐसा करने के लिए, ईटैग का इस्तेमाल करें, ताकि यह पक्का किया जा सके कि ऑब्जेक्ट में कोई गड़बड़ी न हो.
देखें
इवेंट से जुड़े संसाधनों में हुए बदलावों के बारे में जानें.