जब उपयोगकर्ता कैलेंडर और कैलेंडर इवेंट देख रहा होता है या उनमें बदलाव करता है, तब Google Workspace ऐड-ऑन आपकी पसंद के मुताबिक इंटरफ़ेस उपलब्ध करा सकता है. इससे उपयोगकर्ता को काम की अतिरिक्त जानकारी दी जा सकती है, कामों को ऑटोमेट किया जा सकता है, और तीसरे पक्ष के सिस्टम को Google Calendar से कनेक्ट किया जा सकता है.
Google Calendar के लिए ऐड-ऑन इंटरफ़ेस बनाते समय, आपके पास होम पेज उपलब्ध कराने का विकल्प होता है. एक से ज़्यादा होस्ट के लिए एक ही होम पेज का इस्तेमाल किया जा सकता है या Google Calendar के लिए एक खास होम पेज डिज़ाइन किया जा सकता है.
आपका ऐड-ऑन एक इंटरफ़ेस भी बना सकता है, जो उपयोगकर्ता को तब दिखता है, जब कैलेंडर इवेंट खुला हो.
ऐड-ऑन यूज़र इंटरफ़ेस (यूआई) ऐक्सेस करना
इसे खोलने के तरीके के आधार पर, Google Workspace ऐड-ऑन, होम पेज के इंटरफ़ेस, Google Calendar इवेंट के इंटरफ़ेस, अटैचमेंट चुनने के इंटरफ़ेस या इन तीनों को तय कर सकता है:
- अगर कोई उपयोगकर्ता, कैलेंडर व्यू में ऐड-ऑन आइकॉन पर क्लिक करता है, तो ऐड-ऑन उससे जुड़ा
calendar.homepageTriggerफ़ंक्शन (अगर मौजूद हो) लागू करता है. यह फ़ंक्शन होम पेज कार्ड बनाता है और उसे डिसप्ले के लिए कैलेंडर पर दिखाता है. अगर कोईcalendar.homepageTriggerफ़ंक्शन तय नहीं किया गया है, तो उसके बजाय एक सामान्य होम पेज कार्ड दिखाया जाता है. - अगर उपयोगकर्ता किसी कैलेंडर इवेंट को खोलता है और फिर ऐड-ऑन आइकॉन पर क्लिक करता है या
जब उपयोगकर्ता किसी इवेंट को खोलता है, तो ऐड-ऑन खुला होता है. ऐसे में ऐड-ऑन, उससे जुड़े
eventOpenTriggerफ़ंक्शन (अगर मौजूद हो) को चलाता है. यह फ़ंक्शन ऐड-ऑन का कैलेंडर इवेंट इंटरफ़ेस बनाता है और डिसप्ले के लिए 'Google कैलेंडर' पर वापस आता है. - अगर ऐड-ऑन किसी
eventAttachmentTriggerफ़ंक्शन के बारे में बताता है, तो ऐड-ऑन अटैचमेंट देने वाले के तौर पर तब दिखता है, जब उपयोगकर्ता Calendar इवेंट में बदलाव करते समय अटैचमेंट जोड़ें पर क्लिक करता है. जब ऐड-ऑन चुना जाता है, तोeventAttachmentTriggerफ़ंक्शन, ऐड-ऑन के अटैचमेंट को चुनने का इंटरफ़ेस बनाता है और उसे डिसप्ले के लिए Google Calendar पर वापस भेजता है.
ऐड-ऑन Calendar का इंटरफ़ेस बनाना
Google Workspace ऐड-ऑन की मदद से, Google Calendar की अवधि बढ़ाई जा सकती है. इसके लिए, यह तरीका अपनाएं:
- तय करें कि आप अपने ऐड-ऑन पर Calendar के लिए खास होम पेज बनाना चाहते हैं या नहीं. यह भी तय करें कि जब उपयोगकर्ता Calendar इवेंट में बदलाव कर रहा हो, तब कस्टम इंटरफ़ेस उपलब्ध कराया जाए या नहीं.
- ऐड-ऑन स्क्रिप्ट प्रोजेक्ट के मेनिफ़ेस्ट में सही
addOns.commonऔरaddOns.calendarफ़ील्ड जोड़ें. इसमें, सभी दायरे भी शामिल करने ज़रूरी हैं. - अगर आपने Calendar के लिए खास होम पेज उपलब्ध कराया है, तो इस इंटरफ़ेस को बनाने के लिए
calendar.homepageTriggerफ़ंक्शन लागू करें. Google Workspace के एक से ज़्यादा होस्ट के लिए,common.homepageTriggerइंटरफ़ेस का इस्तेमाल करने का विकल्प भी चुना जा सकता है. - अगर आपने Calendar इवेंट का इंटरफ़ेस उपलब्ध कराया है, तो इस इंटरफ़ेस को बनाने के लिए आपको
calendar.eventOpenTriggerफ़ंक्शन लागू करना होगा. जानकारी के लिए Calendar इवेंट इंटरफ़ेस को बढ़ाना देखें. - उपयोगकर्ता के यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन, जैसे कि बटन क्लिक का जवाब देने के लिए, मिलते-जुलते कॉलबैक फ़ंक्शन लागू करें.
Calendar के होम पेज
Google Calendar में, Google Workspace ऐड-ऑन के होम पेज दिखाए जा सकते हैं.
Google Calendar में अपने ऐड-ऑन का सामान्य होम पेज दिखाने के लिए, यह पक्का करें कि ऐड-ऑन के मेनिफ़ेस्ट में addOns.calendar फ़ील्ड मौजूद हो.
इसके अलावा, Calendar के लिए खास तौर पर बनाया गया होम पेज उपलब्ध कराने के लिए, ऐड-ऑन मेनिफ़ेस्ट में
calendar.homepageTrigger
जोड़ें.
दोनों ही मामलों में, आपको अपने ऐड-ऑन के स्क्रिप्ट प्रोजेक्ट में होम पेज ट्रिगर फ़ंक्शन का नाम देना होगा. इस फ़ंक्शन को ज़रूरत पड़ने पर Google Calendar का होम पेज
बनाने के लिए अपने-आप कॉल किया जाता है. आपको होम पेज बनाने के लिए, एक Card या Card ऑब्जेक्ट की कैटगरी बनाने और लौटाने के लिए इस फ़ंक्शन को लागू करना होगा. होम पेज ट्रिगर फ़ंक्शन को एक इवेंट ऑब्जेक्ट
को पैरामीटर के तौर पर पास किया जाता है. इसमें क्लाइंट के प्लैटफ़ॉर्म जैसी कुछ सामान्य जानकारी होती है. होम पेज को बनाने के लिए, इवेंट ऑब्जेक्ट डेटा का इस्तेमाल
किया जा सकता है.
Calendar इवेंट के इंटरफ़ेस को बढ़ाना
अगर उपयोगकर्ता, कैलेंडर इवेंट में बदलाव करता है, तो यह तय करने के लिए कि कौनसा इंटरफ़ेस (अगर कोई है) दिखाया जाए, तो Google Calendar, कॉन्टेक्स्ट के आधार पर ट्रिगर होता है. ट्रिगर चालू होने पर, यह ऐड-ऑन मेनिफ़ेस्ट के calendar.eventOpenTrigger फ़ील्ड में दिए गए संदर्भ के हिसाब से ट्रिगर फ़ंक्शन को लागू करता है.
आपको calendar.eventOpenTrigger फ़ील्ड में दिया गया फ़ंक्शन लागू करना होगा. यह फ़ंक्शन, किसी इवेंट ऑब्जेक्ट को आर्ग्युमेंट के तौर पर स्वीकार करता है. साथ ही, उपयोगकर्ता के इवेंट को खोलने के दौरान, Calendar में दिखाए जाने के लिए ज़रूरी है कि कोई एक Card ऑब्जेक्ट या Card ऑब्जेक्ट दिखाया जाए.
इवेंट के आइटम
जब कोई उपयोगकर्ता किसी Calendar इवेंट को खोलता है, तो एक इवेंट ऑब्जेक्ट बनाया जाता है और उसे calendar.eventOpenTrigger
संदर्भ के हिसाब से ट्रिगर फ़ंक्शन में भेज दिया जाता है. ट्रिगर फ़ंक्शन इस इवेंट ऑब्जेक्ट में दी गई जानकारी का इस्तेमाल करके, यह तय कर सकता है कि ऐड-ऑन कार्ड कैसे बनाए जाएं या ऐड-ऑन के व्यवहार को कैसे कंट्रोल किया जाए. जब ऐड-ऑन पहली बार खोला जाता है, तब इवेंट ऑब्जेक्ट भी बनाए और homepageTrigger फ़ंक्शन को भेजे जाते हैं. साथ ही, जब उपयोगकर्ता इंटरैक्टिव विजेट पर क्लिक करता है या उन्हें चुनता है.
इवेंट ऑब्जेक्ट का पूरा स्ट्रक्चर इवेंट ऑब्जेक्ट में बताया गया है. अगर Calendar, ऐड-ऑन का ऐक्टिंग होस्ट ऐप्लिकेशन है, तो कॉन्टेक्स्ट के हिसाब से ट्रिगर और विजेट इंटरैक्शन इवेंट ऑब्जेक्ट में, कैलेंडर इवेंट ऑब्जेक्ट फ़ील्ड शामिल होता है. इसमें, कैलेंडर से जुड़ी खास क्लाइंट जानकारी होती है.
कैलेंडर इवेंट अपडेट करना
जब कोई उपयोगकर्ता किसी Calendar इवेंट को बदलाव करने के लिए खोलता है, तो कॉन्टेक्स्ट के हिसाब से
calendar.eventOpenTrigger
इवेंट चालू होता है. इसके अलावा,
calendar.eventUpdateTrigger भी ऐसा किया जा सकता है जो उपयोगकर्ता के Calendar इवेंट को अपडेट करने और सेव करने पर चालू होता है. यह ट्रिगर सिर्फ़ तब चालू होता है,
जब उपयोगकर्ता इनमें से एक या एक से ज़्यादा बदलाव करता है:
- एक या उससे ज़्यादा मेहमानों को जोड़ा जाता है.
- एक या उससे ज़्यादा मेहमानों को हटाता है.
- किसी दूसरे कॉन्फ़्रेंसिंग समाधान को जोड़ता या उसमें स्विच करता है.
जब यह ट्रिगर ट्रिगर होता है, तब यह calendar.eventUpdateTrigger मेनिफ़ेस्ट फ़ील्ड में दिए गए ट्रिगर फ़ंक्शन को लागू करता है. कैलेंडर इवेंट में किए गए बदलाव को सेव किए जाने से पहले फ़ंक्शन चलाया जाता है.
आम तौर पर, calendar.eventUpdateTrigger का इस्तेमाल, इनमें से एक या एक से ज़्यादा कामों के लिए किया जाता है:
- कैलेंडर इवेंट में उपयोगकर्ता के बदलावों के जवाब में, ऐड-ऑन के कैलेंडर इवेंट का इंटरफ़ेस अपडेट करें.
- Calendar इवेंट के डेटा को तीसरे पक्ष के सिस्टम, जैसे कि Google Calendar से जुड़े कॉन्फ़्रेंसिंग सिस्टम से सिंक करें.
अगर आपको किसी Calendar इवेंट के डेटा (जैसे कि उसमें शामिल होने वाले लोगों की सूची) में बदलाव करने के लिए अपना ऐड-ऑन चाहिए, तो आपको ऐड-ऑन calendar.currentEventAccess मेनिफ़ेस्ट फ़ील्ड को WRITE या READ_WRITE पर सेट करना होगा. इसके लिए, ऐड-ऑन के पास https://www.googleapis.com/auth/calendar.addons.current.event.write
दायरा भी होना ज़रूरी है.
कॉन्फ़्रेंसिंग से जुड़ी सुविधाएं जोड़ना
कॉन्फ़्रेंसिंग समाधान तीसरे पक्ष के कॉन्फ़्रेंस के ऐसे विकल्प उपलब्ध कराते हैं जिन्हें उपयोगकर्ता Google Calendar इवेंट में जोड़ सकते हैं. तीसरे पक्ष के कॉन्फ़्रेंसिंग की खास जानकारी वाले दस्तावेज़ में, कॉन्फ़्रेंसिंग के नए सलूशन जोड़ने के लिए ऐड-ऑन बनाने के तरीके के बारे में बताया जाता है. इस तरह के एक्सटेंशन के लिए यूज़र इंटरफ़ेस (यूआई) बनाना ज़रूरी नहीं है. जोड़े गए समाधान, बस Google Calendar इवेंट यूज़र इंटरफ़ेस (यूआई) के ड्रॉप-डाउन मेन्यू में विकल्पों के तौर पर दिखते हैं.