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