Calendar की बेहतर सेवा, आपको Apps Script में सार्वजनिक Google Calendar API का इस्तेमाल करने की अनुमति देती है. Apps Script में पहले से मौजूद कैलेंडर सेवा की तरह ही, यह एपीआई भी स्क्रिप्ट को उपयोगकर्ता के 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)
तरीके का ही इस्तेमाल किया गया है.