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
    }
  ],
  "birthdayProperties": {
    "contact": string,
    "type": string,
    "customTypeName": 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 यह जानकारी, उस कैलेंडर के बारे में बताती है जिस पर इवेंट की यह कॉपी दिखती है. सिर्फ़ पढ़ने के लिए. डिफ़ॉल्ट रूप से, यह 'गलत' पर सेट होता है.
birthdayProperties nested object जन्मदिन या खास इवेंट का डेटा. अगर eventType, "birthday" है, तो इस्तेमाल किया जाता है. इम्यूटेबल. लिखा जा सकता है
birthdayProperties.contact string उस संपर्क के संसाधन का नाम जिससे जन्मदिन का यह इवेंट लिंक किया गया है. इसका इस्तेमाल, People API से संपर्क की जानकारी फ़ेच करने के लिए किया जा सकता है. फ़ॉर्मैट: "people/c12345". सिर्फ़ पढ़ने के लिए.
birthdayProperties.customTypeName string इस इवेंट के लिए तय किया गया कस्टम टाइप लेबल. अगर birthdayProperties.type को "custom" पर सेट किया गया है, तो यह अपने-आप भर जाता है. सिर्फ़ पढ़ने के लिए.
birthdayProperties.type string जन्मदिन या खास इवेंट का टाइप. वैल्यू इस तरह की हो सकती हैं:
  • "anniversary" - जन्मदिन के अलावा कोई दूसरी सालगिरह. इसमें हमेशा contact होता है.
  • "birthday" - जन्मदिन का इवेंट. यह डिफ़ॉल्ट मान है.
  • "custom" - कोई खास तारीख, जिसका लेबल customTypeName फ़ील्ड में दिया गया है. इसमें हमेशा contact होता है.
  • "other" - कोई खास तारीख, जो किसी अन्य कैटगरी में नहीं आती और जिसका कोई कस्टम लेबल नहीं होता. इसमें हमेशा contact होता है.
  • "self" - कैलेंडर के मालिक का अपने जन्म की तारीख. इसमें contact नहीं हो सकता.
Calendar API में सिर्फ़ "birthday" टाइप वाले इवेंट बनाए जा सकते हैं. इवेंट बनाने के बाद, उसका टाइप नहीं बदला जा सकता.		 लिखा जा सकता है
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 कॉन्फ़्रेंसिंग के लिए इस्तेमाल किया जाने वाला सलूशन.

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

ये वैल्यू हो सकती हैं:

  • "eventHangout" for Hangouts for consumers (deprecated; existing events may show this conference solution type but new conferences cannot be created)
  • "eventNamedHangout", Google Workspace के उपयोगकर्ताओं के लिए Hangouts के क्लासिक वर्शन के लिए (अब काम नहीं करता; मौजूदा इवेंट में यह कॉन्फ़्रेंस सलूशन दिख सकता है, लेकिन नई कॉन्फ़्रेंस नहीं बनाई जा सकतीं)
  • Google Meet (http://meet.google.com) के लिए "hangoutsMeet"
  • "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 कॉन्फ़्रेंस के लिए उपलब्ध समाधान का टाइप.

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

ये वैल्यू हो सकती हैं:

  • "eventHangout" for Hangouts for consumers (deprecated; existing events may show this conference solution type but new conferences cannot be created)
  • "eventNamedHangout", Google Workspace के उपयोगकर्ताओं के लिए Hangouts के क्लासिक वर्शन के लिए (अब काम नहीं करता; मौजूदा इवेंट में यह कॉन्फ़्रेंस सलूशन दिख सकता है, लेकिन नई कॉन्फ़्रेंस नहीं बनाई जा सकतीं)
  • Google Meet (http://meet.google.com) के लिए "hangoutsMeet"
  • "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-ccc
  • 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 पिक्सल में गैजेट की ऊंचाई. ऊंचाई, शून्य से बड़ी पूर्णांक होनी चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. लिखा जा सकता है
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 का इस्तेमाल करके वापस लाने के लिए, iCalUID पैरामीटर का इस्तेमाल करके events.list तरीके को कॉल करें. किसी इवेंट के 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, EXRULE, 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" - डिफ़ॉल्ट वैल्यू. इवेंट, कैलेंडर में समय को ब्लॉक करता है. यह 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" - उपयोगकर्ता किसी कस्टम जगह से काम कर रहा है.
कोई भी जानकारी, बताए गए नाम के सब-फ़ील्ड में दी जाती है. हालांकि, अगर यह फ़ील्ड खाली है, तो हो सकता है कि यह मौजूद न हो. अन्य सभी फ़ील्ड को अनदेखा कर दिया जाता है.

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

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

तरीके

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

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

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