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