इवेंट किस तरह के हैं

इस पेज पर eventType प्रॉपर्टी और इवेंट टाइप की खास जानकारी के बारे में बताया गया है जो Google Calendar API में उपलब्ध है.

Google Calendar से, उपयोगकर्ता सामान्य इवेंट और ऐसे इवेंट बना सकते हैं इन्हें खास इस्तेमाल के उदाहरणों और कस्टम प्रॉपर्टी के साथ डिज़ाइन किया गया है.

एपीआई में, इवेंट टाइप को इन जगहों पर देखा जा सकता है:

  • सभी इवेंट, eventType के साथ दिखाए जाते हैं.
  • eventType इवेंट संसाधन बनाते या अपडेट करते समय सेट करने की आवश्यकता होती है. अगर नीति सेट नहीं है, 'default' टाइप का इस्तेमाल किया जाएगा.
  • eventTypes को किसी इवेंट:सूची में शामिल किया जा सकता है खास तरह के इवेंट की सूची बनाने के लिए कॉल. अगर कोई टाइप तय नहीं किया गया है, तो हर तरह के इवेंट वापस कर दिया जाएगा.
  • eventTypes को किसी इवेंट:स्मार्टवॉच में बताया जा सकता है खास तरह के इवेंट के बारे में अपडेट पाने के लिए कॉल करें. अगर कोई टाइप नहीं है बताया गया है, तो अनुरोध करने पर हर तरह के इवेंट की सदस्यता ले ली जाएगी.

डिफ़ॉल्ट इवेंट

default इवेंट टाइप वाले इवेंट बनाए जाते हैं और उनका इस्तेमाल मुख्य इवेंट के तौर पर किया जाता है Google Calendar API के संसाधन. वे कई अन्य संगठनों प्रॉपर्टी जिसका इस्तेमाल इवेंट को और ज़्यादा पसंद के मुताबिक बनाने के लिए किया जा सकता है.

यहां जाएं: काम शुरू करने के लिए, इवेंट बनाना Google Calendar के इवेंट.

जन्मदिन

जन्मदिन, पूरे दिन चलने वाले खास इवेंट होते हैं. इनमें सालाना इवेंट होते हैं. उनके पास ये खास जानकारी होती हैं:

  • eventType को इस पर सेट किया गया है 'birthday'.
  • start और end फ़ील्ड में पूरे दिन का इवेंट, जो सिर्फ़ एक दिन का है.
  • visibility फ़ील्ड वैल्यू 'private' होना चाहिए.
  • transparency फ़ील्ड वैल्यू 'transparent' होना चाहिए.
  • बार-बार होने की ज़रूरत हो, जिसका मतलब है कि recurrence फ़ील्ड में यह वैल्यू होनी चाहिए 'RRULE:FREQ=YEARLY'. 29 फ़रवरी को आने वाले जन्मदिन के इवेंट में ये बार-बार होने का नियम लागू करें: 'RRULE:FREQ=YEARLY;BYMONTH=2;BYMONTHDAY=-1'.
  • आपके पास colorId, summary और reminders.
  • किसी दूसरी इवेंट प्रॉपर्टी के साथ काम न करें.

Gmail के इवेंट

इवेंट Gmail से अपने-आप जनरेट होते हैं उनके पास 'fromGmail' इवेंट टाइप होता है.

Google Calendar API, एपीआई का इस्तेमाल करके, इवेंट टाइप बनाने की अनुमति नहीं देता insert तरीका इस्तेमाल किया जाता है.

एपीआई, एपीआई की मदद से colorId, reminders, visibility, transparency, status, private और shared अपडेट का इस्तेमाल करने वाली एक्सटेंडेड प्रॉपर्टी और पैच तरीकों का इस्तेमाल करें.

एपीआई get और list तरीके से इवेंट पढ़ने के लिए Gmail. eventTypes यह हो सकता है: सिर्फ़ Gmail से जनरेट होने वाले इवेंट को सूची में रखने के लिए, 'fromGmail' पर सेट किया गया. अगर कोई टाइप नहीं है बताया गया है, तो Gmail के इवेंट, अन्य सभी तरह के इवेंट के साथ सूची में दिखेंगे.

एपीआई, watch तरीके का इस्तेमाल इन कामों के लिए करता है Google Calendar पर Gmail के इवेंट में होने वाले बदलावों की सदस्यता लें. अगर कोई टाइप नहीं है तय किया गया है, तो 'fromGmail' के साथ-साथ सभी तरह के इवेंट की सदस्यता ली जाएगी.

Gmail के इवेंट को delete का तरीका Google Calendar API.

इसका उपयोग करके Gmail से किसी इवेंट के आयोजक को बदलना मूव करें या update तरीके काम नहीं करते.

फ़ोकस टाइम, अभी मैं छुट्टी पर हूं, और काम करने की जगह की जानकारी

Google Calendar API का इस्तेमाल उन इवेंट को बनाने और मैनेज करने के लिए किया जा सकता है जिनमें Google Calendar इस्तेमाल करने वाले लोगों के स्टेटस में.

ये सुविधाएं केवल प्राथमिक कैलेंडर पर और कुछ के लिए उपलब्ध हैं Google Calendar का इस्तेमाल करने वाले लोग. फ़ोकस टाइम, 'अभी मैं छुट्टी पर हूं' स्टेटस, और काम करने के दौरान फ़ोकस को मैनेज करें जगह की जानकारी के इवेंट देखें.

Google Apps Script में इवेंट के टाइप को एक्सप्लोर करना

Google Apps Script JavaScript पर आधारित क्लाउड है स्क्रिप्टिंग भाषा, जो आपको अपने कारोबार के साथ इंटिग्रेट करने वाले ऐप्लिकेशन बनाने में मदद करती है Google Workspace. स्क्रिप्ट, ब्राउज़र पर आधारित कोड एडिटर में डेवलप की जाती हैं और उन्हें सेव किया जाता है और Google के सर्वर पर चलाया जाता है. Google Apps Script भी देखें क्विकस्टार्ट का इस्तेमाल करके Apps Script को Google Calendar API को अनुरोध भेजने की अनुमति दें.

नीचे दिए गए निर्देशों में बताया गया है कि Google Calendar API: Google Apps Script. Google Calendar API के संसाधनों और तरीकों की पूरी सूची देखने के लिए, रेफ़रंस दस्तावेज़ देखें.

स्क्रिप्ट बनाएं और उसे सेट अप करें

  1. यहां जाकर स्क्रिप्ट बनाएं script.google.com/create.
  2. सेवाएं के आगे बाएं पैनल में, 'सेवा जोड़ें' पर क्लिक करें
  3. Google Calendar API चुनें और जोड़ें पर क्लिक करें.
  4. चालू होने के बाद, एपीआई बाएं पैनल में दिखता है. उपलब्ध तरीके और एपीआई की क्लास को एडिटर में Calendar कीवर्ड का इस्तेमाल करके लिस्ट किया जा सकता है.

(ज़रूरी नहीं) Google Cloud प्रोजेक्ट अपडेट करना

हर Google Apps Script प्रोजेक्ट से एक Google Cloud प्रोजेक्ट जुड़ा होता है. आपका स्क्रिप्ट उस डिफ़ॉल्ट प्रोजेक्ट का इस्तेमाल कर सकती है जो Google Apps Script में अपने-आप होता है बनाता है. अगर आपको पसंद के मुताबिक Google Cloud प्रोजेक्ट का इस्तेमाल करना है, तो इस पर स्विच करें: अलग-अलग स्टैंडर्ड Cloud प्रोजेक्ट शामिल करने होते हैं. Google Cloud प्रोजेक्ट सेट करने के बाद, बाईं ओर मौजूद एडिटर को चुनें कोड एडिटर.

स्क्रिप्ट में कोड जोड़ें

नीचे दिया गया कोड सैंपल, इवेंट की सूची बनाने, पढ़ने, और बनाने का तरीका बताता है eventType की अलग-अलग वैल्यू.

  1. इसे कोड एडिटर में चिपकाएं.

    const CALENDAR_ID = 'CALENDAR_ID' || 'primary';

/** Lists default events. */
function listDefaultEvents() {
  listEvents('default');
}

/** Lists events from Gmail. */
function listEventsFromGmail() {
  listEvents('fromGmail');
}

/**
  * Lists events with the given event type. If no type is specified, lists all events.
  * See https://developers.google.com/calendar/api/v3/reference/events/list
  */
function listEvents(eventType = undefined) {
  // Query parameters for the list request.
  const optionalArgs = {
    eventTypes: eventType ? [eventType] : undefined,
    singleEvents: true,
    timeMax: '2024-07-30T00:00:00+01:00',
    timeMin: '2024-07-29T00:00:00+01:00',
  }
  try {
    var response = Calendar.Events.list(CALENDAR_ID, optionalArgs);
    response.items.forEach(event => console.log(event));
  } catch (exception) {
    console.log(exception.message);
  }
}

/**
  * Reads the event with the given eventId.
  * See https://developers.google.com/calendar/api/v3/reference/events/get
  */
function readEvent() {
  try {
    var response = Calendar.Events.get(CALENDAR_ID, 'EVENT_ID');
    console.log(response);
  } catch (exception) {
    console.log(exception.message);
  }
}

/** Creates a default event. */
function createDefaultEvent() {
  const event = {
    start: { dateTime: '2024-07-30T10:30:00+01:00'},
    end: { dateTime: '2024-07-30T12:30:00+01:00'},
    description: 'Created from Apps Script.',
    eventType: 'default',
    summary: 'Sample event',
  }
  createEvent(event);
}

/**
  * Creates a Calendar event.
  * See https://developers.google.com/calendar/api/v3/reference/events/insert
  */
function createEvent(event) {

  try {
    var response = Calendar.Events.insert(event, CALENDAR_ID);
    console.log(response);
  } catch (exception) {
    console.log(exception.message);
  }
}

    इन्हें बदलें:

    • CALENDAR_ID: इसके लिए कैलेंडर का ईमेल पता पाएं और इवेंट बनाएं. शुरुआत में यह कॉन्सटेंट इस पर सेट है 'primary', जो कि साइन इन किया हुआ उपयोगकर्ता इस मान को बदलने से आप के कैलेंडर के इवेंट पढ़ सकते हैं अन्य उपयोगकर्ताओं को चुनें जिनका ऐक्सेस आपके पास है.
    • EVENT_ID: इवेंट का आईडी. आप इवेंट आईडी फिर से पाने के लिए, इवेंट:सूची.

कोड सैंपल चलाएं

  1. कोड एडिटर के ऊपर, ड्रॉप-डाउन मेन्यू से वह फ़ंक्शन चुनें जिसे आपको चलाना है, और Run पर क्लिक करें.
  2. पहले एक्ज़ीक्यूशन में, आपसे ऐक्सेस के लिए अनुमति मांगी जाती है. समीक्षा करें और अनुमति दें आपके कैलेंडर को ऐक्सेस करने के लिए Apps Script.
  3. स्क्रिप्ट के एक्ज़ीक्यूशन के नतीजों की जांच एक्ज़िक्यूशन लॉग, जो विंडो में सबसे नीचे दिखता है.