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

जब उपयोगकर्ता कैलेंडर और कैलेंडर इवेंट देख रहा हो या उनमें बदलाव कर रहा हो, तब Google Workspace ऐड-ऑन उनकी पसंद के मुताबिक इंटरफ़ेस उपलब्ध करा सकता है. इससे, उपयोगकर्ता को ज़्यादा काम की जानकारी दी जा सकती है, टास्क अपने-आप किए जा सकते हैं, और तीसरे पक्ष के सिस्टम को 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.homepageTrigger भी जोड़ा जा सकता है, ताकि Calendar के हिसाब से बनाया गया होम पेज उपलब्ध कराया जा सके.

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

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

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

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

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

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

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