Google Calendar इंटरफ़ेस बनाना

Google Workspace ऐड-ऑन, उपयोगकर्ता को कैलेंडर और Calendar इवेंट देखने या उनमें बदलाव करने के दौरान, पसंद के मुताबिक इंटरफ़ेस उपलब्ध करा सकते हैं. इसकी मदद से, उपयोगकर्ता को काम की अतिरिक्त जानकारी दी जा सकती है, टास्क को ऑटोमेट किया जा सकता है, और तीसरे पक्ष के सिस्टम को Calendar से कनेक्ट किया जा सकता है.

Calendar के लिए Google Workspace ऐड-ऑन का इंटरफ़ेस बनाते समय, होम पेज उपलब्ध कराया जा सकता है. एक ही होम पेज का इस्तेमाल कई होस्ट के लिए किया जा सकता है. इसके अलावा, Calendar के लिए कोई खास होम पेज डिज़ाइन किया जा सकता है.

आपका ऐड-ऑन, ऐसा इंटरफ़ेस भी तय कर सकता है जो तब दिखता है, जब उपयोगकर्ता ने Calendar इवेंट खोला हो.

ऐड-ऑन के यूज़र इंटरफ़ेस (यूआई) को ऐक्सेस करना

आपके यूज़र इंटरफ़ेस (यूआई) को संदर्भ के हिसाब से कई तरीकों से दिखाया जा सकता है. उदाहरण के लिए, कोई ऐड-ऑन होम पेज इंटरफ़ेस, कैलेंडर इवेंट इंटरफ़ेस, अटैचमेंट चुनने का इंटरफ़ेस या इन तीनों को तय कर सकता है:

• अगर कोई उपयोगकर्ता कैलेंडर व्यू में ऐड-ऑन आइकॉन पर क्लिक करता है, तो ऐड-ऑन, उससे जुड़ा calendar.homepageTrigger फ़ंक्शन (अगर मौजूद है) लागू करता है. यह फ़ंक्शन, Calendar में दिखाने के लिए होम पेज कार्ड बनाता है और उसे दिखाता है. अगर कोई calendar.homepageTrigger फ़ंक्शन तय नहीं किया गया है, तो उसकी जगह होम पेज का सामान्य कार्ड दिखाया जाता है.
• अगर उपयोगकर्ता Calendar में कोई इवेंट खोलता है और फिर ऐड-ऑन आइकॉन पर क्लिक करता है या जब उपयोगकर्ता कोई इवेंट खोलता है, तब ऐड-ऑन खुला होता है, तो ऐड-ऑन, उससे जुड़ा eventOpenTrigger फ़ंक्शन (अगर मौजूद है) लागू करता है. यह फ़ंक्शन, ऐड-ऑन के कैलेंडर इवेंट इंटरफ़ेस को बनाता है और उसे दिखाने के लिए Calendar पर वापस भेजता है.
• अगर ऐड-ऑन में eventAttachmentTrigger फ़ंक्शन तय किया गया है, तो Calendar इवेंट में बदलाव करते समय, अटैचमेंट जोड़ें पर क्लिक करने पर, ऐड-ऑन अटैचमेंट उपलब्ध कराने वाले के तौर पर दिखता है. ऐड-ऑन चुने जाने पर, eventAttachmentTrigger फ़ंक्शन, ऐड-ऑन के अटैचमेंट चुनने का इंटरफ़ेस बनाता है. इसके बाद, इसे Calendar को दिखाता है.

ऐड-ऑन का कैलेंडर इंटरफ़ेस बनाना

अपना यूज़र इंटरफ़ेस (यूआई) बनाने के लिए, यह तरीका अपनाएं. Google Workspace के ऐड-ऑन की मदद से, Calendar की सुविधाओं को बढ़ाया जा सकता है. इसके लिए, यह तरीका अपनाएं:

1. तय करें कि आपको अपने ऐड-ऑन के लिए, Calendar के हिसाब से होम पेज चाहिए या नहीं. यह भी तय करें कि क्या आपको उपयोगकर्ता को Calendar इवेंट में बदलाव करते समय, कस्टम इंटरफ़ेस देना है.
2. ऐड-ऑन स्क्रिप्ट प्रोजेक्ट के मेनिफ़ेस्ट में, सही addOns.common और addOns.calendar फ़ील्ड जोड़ें. साथ ही, ज़रूरी स्कोप भी जोड़ें.
3. अगर आपको Calendar के लिए होम पेज उपलब्ध कराना है, तो इस इंटरफ़ेस को बनाने के लिए calendar.homepageTrigger फ़ंक्शन लागू करें. आपके पास एक से ज़्यादा होस्ट ऐप्लिकेशन के लिए, common.homepageTrigger इंटरफ़ेस का इस्तेमाल करने का विकल्प भी है.
4. अगर आपको Calendar इवेंट का इंटरफ़ेस उपलब्ध कराना है, तो इस इंटरफ़ेस को बनाने के लिए calendar.eventOpenTrigger फ़ंक्शन लागू करें. ज़्यादा जानकारी के लिए, कैलेंडर इवेंट के इंटरफ़ेस को बढ़ाना लेख पढ़ें.
5. उपयोगकर्ता के यूज़र इंटरफ़ेस (यूआई) इंटरैक्शन, जैसे कि बटन पर क्लिक करने का जवाब देने के लिए, उससे जुड़े ज़रूरी कॉलबैक फ़ंक्शन लागू करें.

कैलेंडर के होम पेज

ऐड-ऑन, Google Workspace ऐड-ऑन के होम पेज दिखाने की सुविधा देते हैं. Calendar में अपने ऐड-ऑन का सामान्य होम पेज दिखाने के लिए, पक्का करें कि ऐड-ऑन के मेनिफ़ेस्ट में addOns.calendar फ़ील्ड मौजूद हो.

इसके अलावा, ऐड-ऑन के मेनिफ़ेस्ट में calendar.homepageTrigger जोड़कर, Calendar के लिए होम पेज उपलब्ध कराया जा सकता है.

दोनों ही मामलों में, आपको अपने ऐड-ऑन के स्क्रिप्ट प्रोजेक्ट में होम पेज ट्रिगर फ़ंक्शन का नाम देना होगा. जब ज़रूरत होती है, तब Calendar का होम पेज बनाने के लिए, इस फ़ंक्शन को अपने-आप कॉल किया जाता है. इस फ़ंक्शन को लागू करके, एक Card या Card ऑब्जेक्ट का अरे बनाएं और उसे वापस भेजें. ये ऑब्जेक्ट, होम पेज बनाते हैं. होम पेज ट्रिगर फ़ंक्शन को इवेंट ऑब्जेक्ट पैरामीटर के तौर पर पास किया जाता है. इसमें कुछ सामान्य जानकारी होती है, जैसे कि क्लाइंट का प्लैटफ़ॉर्म. होम पेज को अपनी ज़रूरत के हिसाब से बनाने के लिए, इवेंट ऑब्जेक्ट डेटा का इस्तेमाल करें.

Calendar इवेंट के इंटरफ़ेस को बढ़ाना

Calendar, कॉन्टेक्स्ट के हिसाब से ट्रिगर होने वाली सुविधा पर निर्भर करता है. इससे यह तय होता है कि जब उपयोगकर्ता Calendar इवेंट में बदलाव करता है, तो कौनसे इंटरफ़ेस (अगर कोई हो) को दिखाया जाए. ट्रिगर चालू होने पर, यह ऐड-ऑन मेनिफ़ेस्ट में मौजूद calendar.eventOpenTrigger फ़ील्ड में तय किए गए कॉन्टेक्स्ट के हिसाब से ट्रिगर फ़ंक्शन को लागू करता है.

calendar.eventOpenTrigger फ़ील्ड में दिए गए नाम वाले फ़ंक्शन को लागू करता है. यह फ़ंक्शन, इवेंट ऑब्जेक्ट को आर्ग्युमेंट के तौर पर स्वीकार करता है. साथ ही, इसे एक Card ऑब्जेक्ट या Card ऑब्जेक्ट का कलेक्शन दिखाना होता है, ताकि Calendar में इवेंट खुला होने पर उपयोगकर्ता को यह दिख सके.

इवेंट ऑब्जेक्ट

जब कोई उपयोगकर्ता Calendar इवेंट खोलता है, तब एक इवेंट ऑब्जेक्ट बनाया जाता है और उसे calendar.eventOpenTrigger कॉन्टेक्स्ट के हिसाब से ट्रिगर होने वाले फ़ंक्शन को पास किया जाता है. ट्रिगर फ़ंक्शन, इस इवेंट ऑब्जेक्ट में मौजूद जानकारी का इस्तेमाल करके यह तय कर सकता है कि ऐड-ऑन कार्ड कैसे बनाए जाएं या ऐड-ऑन के व्यवहार को कैसे कंट्रोल किया जाए. जब कोई ऐड-ऑन पहली बार खोला जाता है और जब उपयोगकर्ता इंटरैक्टिव विजेट पर क्लिक करता है या उन्हें चुनता है, तब इवेंट ऑब्जेक्ट भी बनाए जाते हैं और homepageTrigger फ़ंक्शन को पास किए जाते हैं.

इवेंट ऑब्जेक्ट के पूरे स्ट्रक्चर के बारे में इवेंट ऑब्जेक्ट में बताया गया है. जब Calendar, ऐड-ऑन के लिए होस्ट ऐप्लिकेशन के तौर पर काम करता है, तब कॉन्टेक्स्ट के हिसाब से ट्रिगर होने वाले इवेंट ऑब्जेक्ट और विजेट इंटरैक्शन इवेंट ऑब्जेक्ट में Calendar इवेंट ऑब्जेक्ट फ़ील्ड शामिल होता है. इसमें Calendar से जुड़ी क्लाइंट की जानकारी होती है.

कैलेंडर इवेंट अपडेट करना

कॉन्टेक्स्ट के हिसाब से काम करने वाले calendar.eventOpenTrigger के अलावा, calendar.eventUpdateTrigger भी तय किया जा सकता है. यह तब ट्रिगर होता है, जब कोई उपयोगकर्ता Calendar इवेंट को अपडेट करता है और उसे सेव करता है. कॉन्टेक्स्ट के हिसाब से काम करने वाला calendar.eventOpenTrigger तब ट्रिगर होता है, जब कोई उपयोगकर्ता Calendar इवेंट को बदलाव करने के लिए खोलता है. यह ट्रिगर सिर्फ़ तब चालू होता है, जब उपयोगकर्ता इनमें से कोई एक या एक से ज़्यादा बदलाव करता है:

• इससे एक या उससे ज़्यादा लोगों को मीटिंग में शामिल किया जा सकता है.
• इससे एक या उससे ज़्यादा लोगों को मीटिंग से हटाया जा सकता है.
• कॉन्फ़्रेंसिंग के किसी दूसरे समाधान को जोड़ता है या उस पर स्विच करता है.

यह ट्रिगर चालू होने पर, calendar.eventUpdateTrigger मेनिफ़ेस्ट फ़ील्ड में तय किया गया ट्रिगर फ़ंक्शन लागू करता है. यह फ़ंक्शन, Calendar इवेंट में किए गए बदलावों को सेव करने से पहले लागू होता है.

आम तौर पर, calendar.eventUpdateTrigger का इस्तेमाल इनमें से एक या एक से ज़्यादा कामों के लिए किया जाता है:

• उपयोगकर्ता के Calendar इवेंट में किए गए बदलावों के जवाब में, ऐड-ऑन के Calendar इवेंट इंटरफ़ेस को अपडेट करें.
• कैलेंडर इवेंट के डेटा को तीसरे पक्ष के सिस्टम के साथ सिंक करना. जैसे, Calendar से कनेक्ट किया गया कॉन्फ़्रेंसिंग सिस्टम.

अगर आपको अपने ऐड-ऑन से Calendar इवेंट के डेटा (जैसे, उसमें शामिल होने वाले लोगों की सूची) में बदलाव करना है, तो ऐड-ऑन के calendar.currentEventAccess मेनिफ़ेस्ट फ़ील्ड को WRITE या READ_WRITE पर सेट करें. इसके लिए, ऐड-ऑन के पास https://www.googleapis.com/auth/calendar.addons.current.event.write स्कोप भी होना चाहिए.

कॉन्फ़्रेंसिंग के विकल्प जोड़ना

अगर आपके पास तीसरे पक्ष का कॉन्फ़्रेंसिंग सिस्टम है, तो कॉन्फ़्रेंसिंग ऐड-ऑन जोड़कर उसे Calendar के साथ इंटिग्रेट किया जा सकता है. यह सुविधा, पहले Calendar conferencing add-ons के तौर पर बीटा वर्शन में उपलब्ध थी.

कॉन्फ़्रेंसिंग समाधान, तीसरे पक्ष के कॉन्फ़्रेंसिंग विकल्पों को दिखाते हैं. उपयोगकर्ता इन्हें Calendar इवेंट में जोड़ सकते हैं. तीसरे पक्ष की कॉन्फ़्रेंसिंग की खास जानकारी वाले दस्तावेज़ में, ऐसे ऐड-ऑन को बनाने के तरीके के बारे में जानकारी दी गई है जो कॉन्फ़्रेंसिंग के नए समाधान जोड़ता है. इस तरह के एक्सटेंशन के लिए यूज़र इंटरफ़ेस (यूआई) बनाना ज़रूरी नहीं है. जोड़े गए समाधान, Calendar इवेंट के यूज़र इंटरफ़ेस (यूआई) के ड्रॉप-डाउन मेन्यू में विकल्प के तौर पर दिखते हैं.