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

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

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

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

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

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

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

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

आप इन तरीकों से Google Workspace ऐड-ऑन का इस्तेमाल करके, Google Calendar का इस्तेमाल कर सकते हैं:

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

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

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

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

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

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

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

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

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

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

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

कैलेंडर इवेंट अपडेट किए जा रहे हैं

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

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

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

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

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

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

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

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