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 में दिखाने के लिए भेजता है.

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

Google Workspace के ऐड-ऑन की मदद से, Google Calendar में ज़्यादा सुविधाएं जोड़ी जा सकती हैं. इसके लिए, यह तरीका अपनाएं:

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

Calendar के होम पेज

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

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

दोनों ही मामलों में, आपको अपने ऐड-ऑन के स्क्रिप्ट प्रोजेक्ट में, होम पेज ट्रिगर फ़ंक्शन का नाम देना होगा. ज़रूरत पड़ने पर, 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 से जुड़ी क्लाइंट की जानकारी होती है.

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

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

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

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

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

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

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

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

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

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