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

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

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

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

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

Google Workspace ऐड-ऑन को खोलने के तरीके के आधार पर, यह होम पेज इंटरफ़ेस, Google Calendar इवेंट इंटरफ़ेस, अटैचमेंट चुनने का इंटरफ़ेस या इन तीनों को तय कर सकता है:

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

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

Google Calendar में Google Workspace ऐड-ऑन जोड़ने के लिए, यह तरीका अपनाएं:

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

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

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

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

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

कैलेंडर इवेंट इंटरफ़ेस को बढ़ाना

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

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

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

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

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

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

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

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

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

आम तौर पर, 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 इवेंट के यूज़र इंटरफ़ेस (यूआई) के ड्रॉप-डाउन मेन्यू में विकल्प के तौर पर दिखते हैं.