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 के क्लासिक वर्शन के उपयोगकर्ताओं के लिए "eventNamedHangout" (अब सेवा में नहीं है. मौजूदा इवेंट में, इस तरह के कॉन्फ़्रेंस समाधान दिख सकते हैं, लेकिन नई कॉन्फ़्रेंस नहीं बनाई जा सकतीं)
  • Google Meet (http://meet.google.com) के लिए "hangoutsMeet"
  • 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 के क्लासिक वर्शन के उपयोगकर्ताओं के लिए "eventNamedHangout" (अब सेवा में नहीं है. मौजूदा इवेंट में, इस तरह के कॉन्फ़्रेंस समाधान दिख सकते हैं, लेकिन नई कॉन्फ़्रेंस नहीं बनाई जा सकतीं)
  • Google Meet (http://meet.google.com) के लिए "hangoutsMeet"
  • 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 एंट्री पॉइंट का यूआरआई. इसमें ज़्यादा से ज़्यादा 1,300 वर्ण इस्तेमाल किए जा सकते हैं.

फ़ॉर्मैट:

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

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 खास तरह का इवेंट. इवेंट बनाने के बाद, इस सेटिंग में बदलाव नहीं किया जा सकता. संभावित वैल्यू ये हैं:
  • "birthday" - पूरे दिन का एक खास इवेंट, जिसमें इवेंट का सालाना अंतराल है.
  • "default" - एक नियमित इवेंट या आगे बताया नहीं गया इवेंट.
  • "focusTime" - फ़ोकस-टाइम इवेंट.
  • "fromGmail" - Gmail का कोई इवेंट. इस तरह का इवेंट नहीं बनाया जा सकता.
  • "outOfOffice" - 'अभी मैं छुट्टी पर हूं' इवेंट.
  • "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 पिक्सल में गैजेट की चौड़ाई. चौड़ाई, शून्य से बड़ी कोई पूरी संख्या होनी चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. लिखा जा सकता है
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 से 1,024 वर्ण होने चाहिए
  • हर कैलेंडर के लिए आईडी अलग होना चाहिए
यह सिस्टम दुनिया भर में डिस्ट्रिब्यूट किया गया है. इसलिए, हम इस बात की गारंटी नहीं दे सकते कि इवेंट बनाते समय, आईडी की गड़बड़ियों का पता चल जाएगा. टकराव के जोखिम को कम करने के लिए, हमारा सुझाव है कि आप एक पहले से मौजूद यूयूआईडी एल्गोरिदम का इस्तेमाल करें, जैसा कि 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 बार-बार होने वाले इवेंट के लिए, RRule, EX बिना, RDATE, और EXDATE लाइनों की सूची, जैसा कि RFC5545 में बताया गया है. ध्यान दें कि इस फ़ील्ड में DTSTART और DTEND लाइन का इस्तेमाल नहीं किया जा सकता. इवेंट के शुरू और खत्म होने का समय, start और end फ़ील्ड में बताया जाता है. इस फ़ील्ड को किसी एक इवेंट या बार-बार होने वाले इवेंट के लिए इस्तेमाल नहीं किया जाता. लिखा जा सकता है
recurringEventId string बार-बार होने वाले इवेंट के मामले में, यह बार-बार होने वाले इवेंट का id है. इम्यूटेबल.
reminders object पुष्टि किए गए उपयोगकर्ता के लिए, इवेंट के रिमाइंडर की जानकारी. ध्यान दें कि रिमाइंडर बदलने से, बंद होने वाले इवेंट की updated प्रॉपर्टी भी नहीं बदलती.
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" - इवेंट रद्द कर दिया गया है (मिटाया गया). list तरीके से रद्द किए गए इवेंट सिर्फ़ इंक्रीमेंटल सिंक होने पर दिखते हैं (जब syncToken या updatedMin के बारे में बताया गया हो) या अगर showDeleted फ़्लैग true पर सेट हो. get मेथड से ये नतीजे हमेशा दिखते हैं.

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

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

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

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

      मिटाए गए इवेंट के लिए, सिर्फ़ id फ़ील्ड में जानकारी भरी जाती है.

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

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

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

काम करने की जगह की जानकारी जोड़ने के लिए ज़रूरी है.

 लिखा जा सकता है

तरीके

मिटाएं
इवेंट मिटाता है.
पाएं
Google Calendar आईडी के आधार पर इवेंट दिखाता है. iCalendar आईडी का इस्तेमाल करके किसी इवेंट को फिर से पाने के लिए, iCalUID पैरामीटर का इस्तेमाल करकेevents.list तरीके को कॉल करें.
import
इवेंट इंपोर्ट करता है. इस कार्रवाई का इस्तेमाल किसी कैलेंडर में मौजूदा इवेंट की निजी कॉपी जोड़ने के लिए किया जाता है. सिर्फ़ default के eventType वाले इवेंट इंपोर्ट किए जा सकते हैं.

काम न करने वाला व्यवहार: अगर default के अलावा कोई दूसरा इवेंट इंपोर्ट किया गया है, तो उसका टाइप default में बदल दिया जाएगा. साथ ही, उस इवेंट टाइप से जुड़ी सभी प्रॉपर्टी को भी हटा दिया जाएगा.

डालें
कोई इवेंट बनाता है.
instances
खास बार-बार होने वाले इवेंट के इंस्टेंस दिखाता है.
list
खास कैलेंडर पर इवेंट दिखाता है.
क्रम बदलें
किसी इवेंट को दूसरे कैलेंडर में ले जाता है, जैसे कि किसी इवेंट का आयोजक बदल देता है. ध्यान दें कि सिर्फ़ default इवेंट को दूसरी जगह ले जाया जा सकता है; birthday, focusTime, fromGmail, outOfOffice, और workingLocation इवेंट को दूसरी जगह नहीं ले जाया जा सकता.
पैच
किसी इवेंट को अपडेट करता है. यह तरीका, पैच सेमेंटेक्स के साथ काम करता है. ध्यान दें कि हर पैच अनुरोध में तीन कोटा यूनिट का इस्तेमाल होता है; get के बाद update का इस्तेमाल करना पसंद है. आपकी बताई गई फ़ील्ड वैल्यू, मौजूदा वैल्यू को बदल देती हैं. अनुरोध में तय नहीं किए गए फ़ील्ड में कोई बदलाव नहीं होता है. अगर अरे फ़ील्ड को चुना गया है, तो मौजूदा अरे को ओवरराइट कर दिया जाएगा; यह पिछले किसी भी अरे एलिमेंट को खारिज कर देता है.
quickAdd
सरल टेक्स्ट स्ट्रिंग के आधार पर इवेंट बनाता है.
अपडेट करें
किसी इवेंट को अपडेट करता है. इस तरीके में पैच सिमेंटिक्स काम नहीं करता और हमेशा पूरे इवेंट रिसॉर्स को अपडेट करता है. कुछ हिस्से को अपडेट करने के लिए, get के बाद update करें. साथ ही, एटमिटी (एक बार में पूरा अपडेट) को पक्का करने के लिए, etags का इस्तेमाल करें.
देखें
इवेंट के संसाधनों में हुए बदलावों को देखें.