उपयोगकर्ताओं के कैलेंडर को ऐक्सेस करने और उनमें बदलाव करने के लिए स्क्रिप्ट. इसमें अतिरिक्त सुविधाएं भी शामिल हैं.
Calendar की ऐडवांस सेवा की मदद से, Google Apps Script में Google Calendar के सार्वजनिक एपीआई का इस्तेमाल किया जा सकता है. Apps Script में शामिल Calendar की सेवा की तरह ही, यह एपीआई स्क्रिप्ट को उपयोगकर्ता के Google Calendar को ऐक्सेस करने और उसमें बदलाव करने की अनुमति देता है. इसमें वे अतिरिक्त कैलेंडर भी शामिल हैं जिनकी सदस्यता उपयोगकर्ता ने ली है. ज़्यादातर मामलों में, Calendar की सेवा का इस्तेमाल करना आसान होता है. हालांकि, ऐडवांस सेवा में कुछ अतिरिक्त सुविधाएं मिलती हैं. इनमें, अलग-अलग इवेंट के लिए बैकग्राउंड का रंग सेट करना शामिल है.
यह एक ऐडवांस सेवा है. इसका इस्तेमाल करने से पहले, इसे चालू करना ज़रूरी है.
संदर्भ
इस सेवा के बारे में ज़्यादा जानकारी पाने के लिए, Calendar के सार्वजनिक एपीआई के रेफ़रंस दस्तावेज़ देखें. Apps Script में शामिल सभी ऐडवांस सेवाओं की तरह, Calendar की ऐडवांस सेवा में भी सार्वजनिक एपीआई वाले ऑब्जेक्ट, तरीके, और पैरामीटर इस्तेमाल किए जाते हैं. ज़्यादा जानकारी के लिए, यह लेख पढ़ें कि किसी तरीके के सिग्नेचर कैसे तय किए जाते हैं.
समस्याओं की शिकायत करने और अन्य सहायता पाने के लिए, Calendar की सहायता से जुड़ी गाइड देखें.
एचटीटीपी अनुरोध के हेडर
Calendar की ऐडवांस सेवा, एचटीटीपी अनुरोध के हेडर If-Match और If-None-Match को स्वीकार कर सकती है. ज़्यादा जानकारी के लिए, रेफ़रंस दस्तावेज़ देखें.
नमूना कोड
यहां दिए गए नमूना कोड में, एपीआई के तीसरे वर्शन का इस्तेमाल किया गया है.
इवेंट बनाना
यहां दिए गए उदाहरण में, उपयोगकर्ता के डिफ़ॉल्ट कैलेंडर में इवेंट बनाने का तरीका बताया गया है.
कैलेंडर की सूची देखना
यहां दिए गए उदाहरण में, उपयोगकर्ता के कैलेंडर की सूची में दिखने वाले कैलेंडर के बारे में जानकारी पाने का तरीका बताया गया है.
इवेंट की सूची देखना
यहां दिए गए उदाहरण में, उपयोगकर्ता के डिफ़ॉल्ट कैलेंडर में आने वाले अगले 10 इवेंट की सूची देखने का तरीका बताया गया है.
किसी इवेंट में कुछ शर्तों के साथ बदलाव करना
यहां दिए गए उदाहरण में, If-Match हेडर का इस्तेमाल करके, Calendar के किसी इवेंट को कुछ शर्तों के साथ अपडेट करने का तरीका बताया गया है. स्क्रिप्ट, एक नया इवेंट बनाती है. इसके बाद, 30 सेकंड इंतज़ार करती है. फिर, इवेंट को सिर्फ़ तब अपडेट करती है, जब इवेंट बनने के बाद से उसकी जानकारी में कोई बदलाव न हुआ हो.
किसी इवेंट को कुछ शर्तों के साथ वापस पाना
यहां दिए गए उदाहरण में, If-None-Match हेडर का इस्तेमाल करके, Calendar के किसी इवेंट को कुछ शर्तों के साथ फ़ेच करने का तरीका बताया गया है. स्क्रिप्ट, एक नया इवेंट बनाती है. इसके बाद, 30 सेकंड तक इवेंट में होने वाले बदलावों की पोलिंग करती है. जब भी इवेंट में कोई बदलाव होता है, तो उसका नया वर्शन फ़ेच किया जाता है.
इवेंट सिंक करना
यहां दिए गए उदाहरण में, सिंक टोकन का इस्तेमाल करके, इवेंट वापस पाने का तरीका बताया गया है. Calendar की ऐडवांस सेवा के अनुरोध में सिंक टोकन शामिल करने पर, मिलने वाले जवाब में सिर्फ़ वे आइटम शामिल होते हैं जिनमें उस टोकन के जनरेट होने के बाद से बदलाव हुआ है. इससे, ज़्यादा बेहतर तरीके से प्रोसेसिंग की जा सकती है. सिंक करने की प्रोसेस के बारे में ज़्यादा जानने के लिए, संसाधनों को बेहतर तरीके से सिंक करना लेख पढ़ें.
यहां दिए गए उदाहरण में, पहले दिए गए उदाहरणों में तय किए गए getRelativeDate(daysOffset, hour) तरीके का इस्तेमाल किया गया है.