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 कॉन्फ़्रेंसिंग के लिए इस्तेमाल किया जाने वाला सलूशन.

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

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

  • उपभोक्ताओं के लिए 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"
  • "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 वह टाइम ज़ोन जिसमें समय बताया गया है. (आईएएनए टाइम ज़ोन डेटाबेस के नाम के तौर पर फ़ॉर्मैट किया गया, जैसे कि "Europe/Zurich".) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी है. साथ ही, यह उस टाइम ज़ोन के बारे में बताता है जिसमें बार-बार होने वाले इवेंट को बड़ा किया जाता है. एक बार होने वाले इवेंट के लिए, यह फ़ील्ड ज़रूरी नहीं है. यह इवेंट के शुरू/खत्म होने के लिए, कस्टम टाइम ज़ोन दिखाता है. लिखा जा सकता है
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 वह टाइम ज़ोन जिसमें समय बताया गया है. (आईएएनए टाइम ज़ोन डेटाबेस के नाम के तौर पर फ़ॉर्मैट किया गया, जैसे कि "Europe/Zurich".) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी है. साथ ही, यह उस टाइम ज़ोन के बारे में बताता है जिसमें बार-बार होने वाले इवेंट को बड़ा किया जाता है. एक बार होने वाले इवेंट के लिए, यह फ़ील्ड ज़रूरी नहीं है. यह इवेंट के शुरू/खत्म होने के लिए, कस्टम टाइम ज़ोन दिखाता है. लिखा जा सकता है
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 वह टाइम ज़ोन जिसमें समय बताया गया है. (आईएएनए टाइम ज़ोन डेटाबेस के नाम के तौर पर फ़ॉर्मैट किया गया, जैसे कि "Europe/Zurich".) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी है. साथ ही, यह उस टाइम ज़ोन के बारे में बताता है जिसमें बार-बार होने वाले इवेंट को बड़ा किया जाता है. एक बार होने वाले इवेंट के लिए, यह फ़ील्ड ज़रूरी नहीं है. यह इवेंट के शुरू/खत्म होने के लिए, कस्टम टाइम ज़ोन दिखाता है. लिखा जा सकता है
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" - इवेंट, कैलेंडर पर समय को ब्लॉक नहीं करता. यह 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 पैरामीटर का इस्तेमाल करके events.list का तरीका कॉल करें.
import
कोई इवेंट इंपोर्ट करता है. इस कार्रवाई का इस्तेमाल किसी कैलेंडर में मौजूदा इवेंट की निजी कॉपी जोड़ने के लिए किया जाता है. सिर्फ़ ऐसे इवेंट इंपोर्ट किए जा सकते हैं जिनका eventType default हो.

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

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