Events

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

कैलेंडर 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": {
    "homeOffice": (value),
    "customLocation": {
      "label": string
    },
    "officeLocation": {
      "buildingId": string,
      "floorId": string,
      "floorSectionId": string,
      "deskId": string,
      "label": 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 में मौजूद फ़ाइलों के लिए, यह आईडी आईडी Files Drive API से जुड़ी एक ही संसाधन आईडी का आईडी होता है.

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

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

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

लिखा जा सकता है
attachments[].mimeType string इंटरनेट मीडिया टाइप (MIME टाइप) वाला अटैचमेंट.
attachments[].title string अटैचमेंट का शीर्षक.
attendeesOmitted boolean हो सकता है कि मेहमानों को इवेंट के प्रतिनिधित्व से हटा दिया गया हो. जब कोई इवेंट मिलता है, तो ऐसा maxAttendee क्वेरी पैरामीटर में बताई गई पाबंदी की वजह से हो सकता है. किसी इवेंट को अपडेट करते समय, इसका इस्तेमाल, मीटिंग में हिस्सा लेने वाले व्यक्ति के जवाब को अपडेट करने के लिए ही किया जा सकता है. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, 'गलत है' पर क्लिक किया जाता है. लिखा जा सकता है
attendees[] list इवेंट में शामिल होने वाले लोगों के लिए. दूसरे कैलेंडर उपयोगकर्ताओं के साथ इवेंट शेड्यूल करने के बारे में ज़्यादा जानकारी पाने के लिए, इवेंट में आने वाले लोगों के साथ इवेंट गाइड देखें. मेहमान खातों की सूची में अपने-आप जानकारी भरने के लिए, सेवा खातों को पूरे डोमेन के लिए अनुमति देना ज़रूरी है. लिखा जा सकता है
attendees[].additionalGuests integer अतिरिक्त मेहमानों की संख्या. ज़रूरी नहीं. डिफ़ॉल्ट सेटिंग 0 होती है. लिखा जा सकता है
attendees[].comment string मेहमान के जवाब की टिप्पणी. ज़रूरी नहीं. लिखा जा सकता है
attendees[].displayName string अगर उपलब्ध हो, तो मेहमान का नाम. ज़रूरी नहीं. लिखा जा सकता है
attendees[].email string अगर उपलब्ध हो, तो मेहमान का ईमेल पता. किसी मेहमान को जोड़ते समय यह फ़ील्ड मौजूद होना चाहिए. RFC5322 के मुताबिक यह एक मान्य ईमेल पता होना चाहिए.

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

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

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

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

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

conferenceData.conferenceSolution nested object कॉन्फ़्रेंस का समाधान, जैसे कि Google Meet.

जो कॉन्फ़्रेंस नहीं बनाया जा सका, उसे अनसेट करें.

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

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

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

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

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

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

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

conferenceData.createRequest.conferenceSolutionKey nested object कॉन्फ़्रेंस समाधान, जैसे कि Hangouts या Google Meet.
conferenceData.createRequest.conferenceSolutionKey.type string कॉन्फ़्रेंस समाधान का प्रकार.

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

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

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

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

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

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

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

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

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

उन सभी को एक ही कॉन्फ़्रेंस से होना चाहिए.

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

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

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

ज़रूरी नहीं.

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

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

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

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

उदाहरण के लिए:

  • video के लिए: meet.google.com/aaa-bbbb-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,113,355789;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 संसाधन का ईटैग.
eventType string इवेंट का खास टाइप. रीड-ओनली. वैल्यू इस तरह की हो सकती हैं:
  • "default" - कोई सामान्य इवेंट या आगे तय नहीं किया गया.
  • "outOfOffice" - 'अभी मैं छुट्टी पर हूं' इवेंट.
  • "focusTime" - फ़ोकस टाइम इवेंट.
  • "workingLocation" - जगह की जानकारी का इवेंट चालू है.
extendedProperties object इवेंट की बढ़ाई गई प्रॉपर्टी.
extendedProperties.private object ऐसी प्रॉपर्टी जो इस कैलेंडर पर दिखने वाले इवेंट की कॉपी के साथ निजी होती हैं. लिखा जा सकता है
extendedProperties.private.(key) string निजी प्रॉपर्टी का नाम और उससे जुड़ी वैल्यू.
extendedProperties.shared object ऐसी प्रॉपर्टी जिन्हें मेहमानों के कैलेंडर पर, इवेंट की कॉपी के बीच शेयर किया जाता है. लिखा जा सकता है
extendedProperties.shared.(key) string शेयर की गई प्रॉपर्टी का नाम और उससे जुड़ी वैल्यू.
gadget object इस इवेंट की अवधि बढ़ाने वाला गैजेट. गैजेट बहिष्कृत कर दिए गए हैं; इसकी बजाय इस संरचना का उपयोग केवल जन्मदिन कैलेंडर कैलेंडर लौटने के लिए किया जाता है.
gadget.display string गैजेट का प्रदर्शन मोड. समर्थन नहीं होना या रुकना. वैल्यू इस तरह की हो सकती हैं:
  • "icon" - गैजेट, कैलेंडर व्यू में इवेंट के शीर्षक के आगे दिखता है.
  • "chip" - गैजेट, इवेंट पर क्लिक किए जाने पर दिखाता है.
लिखा जा सकता है
gadget.height integer गैजेट की ऊंचाई पिक्सल में. ऊंचाई 0 से ज़्यादा होना चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. लिखा जा सकता है
gadget.preferences object प्राथमिकताएं पर टैप करें. लिखा जा सकता है
gadget.preferences.(key) string प्राथमिकता का नाम और उससे जुड़ी वैल्यू.
gadget.title string गैजेट का शीर्षक. समर्थन नहीं होना या रुकना. लिखा जा सकता है
gadget.type string गैजेट का प्रकार. समर्थन नहीं होना या रुकना. लिखा जा सकता है
gadget.width integer गैजेट की चौड़ाई पिक्सल में. चौड़ाई 0 से बड़ी कोई पूर्णांक संख्या होनी चाहिए. ज़रूरी नहीं. समर्थन नहीं होना या रुकना. लिखा जा सकता है
guestsCanInviteOthers boolean आयोजक के अलावा, इवेंट में शामिल होने वाले अन्य लोगों को भी न्योता भेजा जा सकता है या नहीं. ज़रूरी नहीं. डिफ़ॉल्ट वैल्यू 'सही है' है. लिखा जा सकता है
guestsCanModify boolean आयोजक के अलावा, इवेंट में शामिल होने वाले अन्य लोग भी इसमें बदलाव कर सकते हैं. ज़रूरी नहीं. डिफ़ॉल्ट रूप से, 'गलत है' पर क्लिक किया जाता है. लिखा जा सकता है
guestsCanSeeOtherGuests boolean इवेंट के आयोजक के अलावा, कोई दूसरा व्यक्ति यह देख सकता है कि इवेंट में शामिल होने वाले लोग कौन हैं. ज़रूरी नहीं. डिफ़ॉल्ट वैल्यू 'सही है' है. लिखा जा सकता है
iCalUID string आरएफ़सी5545 में बताए गए तरीके से, इवेंट का यूनीक आइडेंटिफ़ायर. इसका इस्तेमाल, कैलेंडर सिस्टम में इवेंट की पहचान करने के लिए किया जाता है. साथ ही, इवेंट को इंपोर्ट करने के तरीके से इंपोर्ट करना ज़रूरी है.

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

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

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

ध्यान दें कि 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 समय क्षेत्र डेटाबेस नाम, जैसे "यूरोप/ज़्यूरिख" के रूप में फ़ॉर्मैट किया गया.) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी होता है. साथ ही, यह उस टाइम ज़ोन के बारे में भी बताता है जिसमें दोहराए जाने वाले इवेंट को बढ़ाया जाता है. यह इवेंट वैकल्पिक है और इवेंट के शुरू/खत्म होने के लिए कस्टम समय क्षेत्र दिखाता है. लिखा जा सकता है
privateCopy boolean अगर इस नीति को 'सही है' पर सेट किया जाता है, तो इवेंट का प्रमोशन बंद रहता है. ध्यान दें कि यह निजी इवेंट प्रॉपर्टी से अलग है. ज़रूरी नहीं. नहीं बदले जा सकते. डिफ़ॉल्ट रूप से, 'गलत है' पर क्लिक किया जाता है.
recurrence[] list आरएफ़सी5545 में बताए गए किसी बार-बार होने वाले इवेंट के लिए Rनियमों, EXREQUEST, RDATE, और EXDATE लाइनों की सूची. ध्यान दें कि इस फ़ील्ड में DTSTART और DTEND लाइनों की अनुमति नहीं है. इवेंट के शुरू और खत्म होने के समय start और end फ़ील्ड में दिए जाते हैं. यह फ़ील्ड किसी एक इवेंट या बार-बार होने वाले इवेंट के उदाहरणों के लिए छोड़ दिया जाता है. लिखा जा सकता है
recurringEventId string किसी बार-बार होने वाले इवेंट के उदाहरण के लिए, यह बार-बार होने वाले इवेंट का id है. नहीं बदले जा सकते.
reminders object पुष्टि किए गए उपयोगकर्ता के लिए, इवेंट के रिमाइंडर के बारे में जानकारी.
reminders.overrides[] list अगर इवेंट, डिफ़ॉल्ट रिमाइंडर का इस्तेमाल नहीं करता है, तो इवेंट के लिए खास तौर पर रिमाइंडर सेट होते हैं. अगर ऐसा नहीं होता, तो इसका मतलब है कि इस इवेंट के लिए कोई रिमाइंडर सेट नहीं है. ओवरराइड रिमाइंडर की संख्या ज़्यादा से ज़्यादा पांच हो सकती है. लिखा जा सकता है
reminders.overrides[].method string इस रिमाइंडर में इस्तेमाल किया गया तरीका. वैल्यू इस तरह की हो सकती हैं:
  • "email" - रिमाइंडर, ईमेल से भेजे जाते हैं.
  • "popup" - रिमाइंडर, यूज़र इंटरफ़ेस (यूआई) पॉप-अप की मदद से भेजे जाते हैं.

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

लिखा जा सकता है
reminders.overrides[].minutes integer रिमाइंडर के ट्रिगर होने का समय, इवेंट शुरू होने से इतने मिनट पहले. वैल्यू, 0 से 40320 (मिनट में चार हफ़्ते) के बीच होती हैं.

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

लिखा जा सकता है
reminders.useDefault boolean कैलेंडर के डिफ़ॉल्ट रिमाइंडर, इवेंट पर लागू होते हैं या नहीं. लिखा जा सकता है
sequence integer iCalendar के मुताबिक क्रम संख्या. लिखा जा सकता है
source object जिस सोर्स से इवेंट बनाया गया. उदाहरण के लिए, कोई वेब पेज, ईमेल मैसेज या एचटीटीपी या एचटीटीपीएस स्कीम वाले यूआरएल से पहचाना जा सकने वाला दस्तावेज़. इसे सिर्फ़ इवेंट बनाने वाला देख सकता है या उसमें बदलाव कर सकता है.
source.title string स्रोत का शीर्षक; उदाहरण के लिए, किसी वेब पेज का शीर्षक या ईमेल का विषय. लिखा जा सकता है
source.url string किसी संसाधन पर ले जाने वाले सोर्स का यूआरएल. यूआरएल स्कीम एचटीटीपी या एचटीटीपीएस होनी चाहिए. लिखा जा सकता है
start nested object इवेंट के शुरू होने का समय (शामिल है) किसी बार-बार होने वाले इवेंट के लिए, यह पहले इंस्टेंस का शुरू होने का समय है.
start.date date अगर यह पूरे दिन का इवेंट है, तो "yyyy-mm-dd" फ़ॉर्मैट में तारीख. लिखा जा सकता है
start.dateTime datetime समय को तारीख और समय के मिले-जुले रूप में (RFC3339 के मुताबिक फ़ॉर्मैट किया गया). timeZone में टाइम ज़ोन ऑफ़सेट की जानकारी देना ज़रूरी है. लिखा जा सकता है
start.timeZone string समय क्षेत्र जिसमें समय बताया गया है. (IANA समय क्षेत्र डेटाबेस नाम, जैसे "यूरोप/ज़्यूरिख" के रूप में फ़ॉर्मैट किया गया.) बार-बार होने वाले इवेंट के लिए यह फ़ील्ड ज़रूरी होता है. साथ ही, यह उस टाइम ज़ोन के बारे में भी बताता है जिसमें दोहराए जाने वाले इवेंट को बढ़ाया जाता है. यह इवेंट वैकल्पिक है और इवेंट के शुरू/खत्म होने के लिए कस्टम समय क्षेत्र दिखाता है. लिखा जा सकता है
status string इवेंट की स्थिति. ज़रूरी नहीं. वैल्यू इस तरह की हो सकती हैं:
  • "confirmed" - इवेंट की पुष्टि हो गई है. यह डिफ़ॉल्ट स्थिति है.
  • "tentative" - इवेंट की पुष्टि अस्थायी तौर पर की गई है.
  • "cancelled" - इवेंट रद्द कर दिया गया है (मिटा दिया गया है). सूची वाला तरीका रद्द किए गए इवेंट को सिर्फ़ इंक्रीमेंटल सिंक (जब syncToken या updatedMin के बारे में बताया गया हो) पर देता है या showDeleted फ़्लैग को true पर सेट किया जाता है. get तरीका उन्हें हमेशा दिखाता है.

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

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

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

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

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

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

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

लिखा जा सकता है
summary string इवेंट का शीर्षक. लिखा जा सकता है
transparency string इवेंट, कैलेंडर पर समय को रोक रहा है या नहीं. ज़रूरी नहीं. वैल्यू इस तरह की हो सकती हैं:
  • "opaque" - डिफ़ॉल्ट वैल्यू. इवेंट, कैलेंडर पर समय को रोक देता है. यह यूज़र इंटरफ़ेस (यूआई) को कैलेंडर यूज़र इंटरफ़ेस (यूआई) पर व्यस्त के तौर पर सेट करने के बराबर है.
  • "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 ज़्यादा जानकारी के लिए, एक वैकल्पिक लेबल.

तरीके

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