कैलेंडर प्राप्त करना

Google Apps Script में Google Calendar के साथ काम करने के लिए एक लाइब्रेरी, CalendarApp क्लास, पहले से शामिल होती है।

इस लेख में CalendarApp क्लास का उपयोग करके CalendarApp.Calendar ऑब्जेक्ट प्राप्त करने का तरीका समझाया गया है, जो कई तरह के ऑपरेशन का शुरुआती बिंदु होता है।

GAS से Google Calendar को ऐक्सेस किया जाता है, इसलिए पहली बार चलाते समय अनुमतियाँ (authorization) देनी होंगी।

इस पेज पर बताए गए फ़ंक्शन का सारांश

अगर आप सिर्फ़ कैलेंडर प्राप्त करने वाले फ़ंक्शन जानना चाहते हैं, तो नीचे दी गई टैब लिस्ट में से अपनी ज़रूरत का टैब चुनकर फ़ंक्शन का सैंपल देख सकते हैं।

/** @type { CalendarApp.Calendar[] }  */
const calendars = CalendarApp.getAllCalendars();

/** @type { CalendarApp.Calendar[] }  */
const calendars = CalendarApp.getAllOwnedCalendars();

const CALENDAR_ID = "___प्राप्त किए जाने वाले कैलेंडर की ID___"

/** @type { CalendarApp.Calendar | null }  */
const calendar = CalendarApp.getCalendarById(CALENDAR_ID);

const CALENDAR_NAME = "ToDo लिस्ट"

/** @type { CalendarApp.Calendar[] }  */
const calendars = CalendarApp.getCalendarsByName(CALENDAR_NAME);

मालिक चाहे कोई भी हो, सभी कैलेंडर प्राप्त करना

Google Calendar में आपके अपने स्वामित्व वाले कैलेंडर के साथ-साथ वे कैलेंडर भी दिखते हैं, जिन्हें दूसरे यूज़र ने बनाया है और आपने सब्सक्राइब किया है।

अगर आप ये सभी कैलेंडर प्राप्त करना चाहते हैं, तो CalendarApp.getAllCalendars फ़ंक्शन का इस्तेमाल करें।

इस्तेमाल होने वाला मेथड

/**
 * @return { CalendarApp.Calendar[] } यूज़र के स्वामित्व वाले या उसके द्वारा सब्सक्राइब किए गए सभी कैलेंडर
 */
CalendarApp.getAllCalendars;

सैंपल कोड

/** सभी कैलेंडर */
const calendars = CalendarApp.getAllCalendars();

console.log(`${calendars.length} कैलेंडर प्राप्त किए गए`);

for (const calendar of calendars) {
  console.log(`कैलेंडर का नाम "${calendar.getName()}" है`);
}

अपने स्वामित्व वाले सभी कैलेंडर प्राप्त करना

अगर आप दूसरे यूज़र द्वारा बनाए गए और आपके द्वारा सब्सक्राइब किए गए कैलेंडर को छोड़कर, सिर्फ़ अपने स्वामित्व वाले कैलेंडर प्राप्त करना चाहते हैं, तो CalendarApp.getAllOwnedCalendars फ़ंक्शन का इस्तेमाल करें।

इस्तेमाल होने वाला मेथड

/**
 * @return { CalendarApp.Calendar[] } अपने स्वामित्व वाले सभी कैलेंडर
 */
CalendarApp.getAllOwnedCalendars;

सैंपल कोड

/** अपने स्वामित्व वाले सभी कैलेंडर */
const calendars = CalendarApp.getAllOwnedCalendars();

console.log(`${calendars.length} कैलेंडर प्राप्त किए गए`);

for (const calendar of calendars) {
  console.log(`कैलेंडर का नाम "${calendar.getName()}" है`);
}

ID देकर प्राप्त करना

किसी एक खास कैलेंडर को उसकी ID देकर प्राप्त किया जा सकता है।

इसके लिए CalendarApp.getCalendarById फ़ंक्शन का इस्तेमाल करें।

इस्तेमाल होने वाला मेथड

/**
 * @return { CalendarApp.Calendar | null } लक्षित कैलेंडर
 */
CalendarApp.getCalendarById;

अगर दी गई ID वाला कोई कैलेंडर मौजूद नहीं है, स्क्रिप्ट चलाने वाला यूज़र उस कैलेंडर को ऐक्सेस नहीं कर सकता, या उसने कैलेंडर को सब्सक्राइब नहीं किया है, तो null लौटाया जाता है।

सैंपल कोड

/** कैलेंडर की ID */
const CALENDAR_ID = '___प्राप्त किए जाने वाले कैलेंडर की ID___';

function myFunction() {
  /** लक्षित कैलेंडर */
  const calendar = CalendarApp.getCalendarById(CALENDAR_ID);

  if (!calendar) {
    console.log('कैलेंडर नहीं मिला');
    return;
  }

  console.log(`कैलेंडर का नाम "${calendar.getName()}" है`);
}

नाम देकर प्राप्त करना

किसी खास कैलेंडर को उसका नाम देकर प्राप्त किया जा सकता है।

इसके लिए CalendarApp.getCalendarsByName फ़ंक्शन का इस्तेमाल करें।

इस्तेमाल होने वाला मेथड

/**
 * @return { CalendarApp.Calendar[] } लक्षित कैलेंडर
 */
CalendarApp.getCalendarsByName;

आपके स्वामित्व वाले या आपके द्वारा सब्सक्राइब किए गए कैलेंडर में से, जिनका नाम मेल खाता है, वे कैलेंडर प्राप्त होते हैं। नाम में अपरकेस और लोअरकेस का अंतर नहीं माना जाता।

एक ही नाम के कई कैलेंडर हो सकते हैं, इसलिए प्राप्त होने वाले कैलेंडर एक ऐरे के रूप में मिलते हैं।

अगर एक ही नाम के 2 कैलेंडर मौजूद हैं, तो दोनों प्राप्त होंगे।

सैंपल कोड

/** कैलेंडर का नाम */
const CALENDAR_NAME = 'ToDo लिस्ट';

/** लक्षित कैलेंडर */
const calendars = CalendarApp.getCalendarsByName(CALENDAR_NAME);

console.log(`${CALENDAR_NAME} नाम के ${calendars.length} कैलेंडर मौजूद हैं`);