Google Meet के ऐड-ऑन के डिज़ाइन के लिए, इन गाइड में दिए गए निर्देशों का पालन करें. इससे, आपके उपयोगकर्ताओं को बेहतर अनुभव मिलेगा.
अनुमति देने के सबसे सही तरीके
हमारा सुझाव है कि पुष्टि करने या अनुमति देने की सुविधा वाले Google Meet के किसी भी ऐड-ऑन के लिए, यहां दिए गए सबसे सही तरीके अपनाएं.
Google साइन-इन का इस्तेमाल करना
Google Workspace ऐड-ऑन का इस्तेमाल करने वाले कई लोग, मीटिंग में शामिल होने से पहले ही Google में साइन इन कर चुके होंगे. इसलिए, Google One Tap को विकल्प के तौर पर उपलब्ध कराने से, साइन-इन करने के दौरान उपयोगकर्ताओं को कई क्लिक करने से बचाया जा सकता है. ज़्यादा जानकारी के लिए, अपने ऐड-ऑन के लिए साइन-इन करने के तरीके मैनेज करना लेख पढ़ें.
तीसरे पक्ष के साइन-इन पेज को नई विंडो में खोलें
Google से साइन इन करने के अलावा, आपका ऐप्लिकेशन साइन इन करने के अन्य तरीके भी उपलब्ध करा सकता है. अगर ऐसा है, तो नए टैब में साइन-इन पेज खोलने के बजाय, डायलॉग विंडो का इस्तेमाल करें. इस तरह, उपयोगकर्ता अब भी Meet कॉल देख सकता है और उस पर वापस जा सकता है. साथ ही, उसे कम क्लिक करने पड़ेंगे.
Google API के लिए स्कोप का सही तरीके से अनुरोध करना
अगर आपका Meet ऐड-ऑन, Google API को कॉल करता है, तो आपको अपने ऐड-ऑन के लिए ज़रूरी OAuth स्कोप की पूरी सूची देनी होगी. यह काम, Google Workspace Marketplace के ऐप्लिकेशन कॉन्फ़िगरेशन पेज पर किया जाता है. इन स्कोप को जोड़ने के बाद, जब उपयोगकर्ता आपका Meet ऐड-ऑन इंस्टॉल करते हैं, तो उन्हें एक प्रॉम्प्ट दिखता है. इसमें बताया जाता है कि वे किस तरह के डेटा को आपके ऐप्लिकेशन को ऐक्सेस करने की अनुमति दे रहे हैं.
अपने ऐड-ऑन को पब्लिश करने से पहले, आपको OAuth की सहमति स्क्रीन भी सेट अप करनी होगी. इसके लिए, आपको Google Workspace Marketplace के ऐप्लिकेशन कॉन्फ़िगरेशन से, अनुमति के ठीक वही स्कोप जोड़ने होंगे. OAuth के लिए सहमति की स्क्रीन को कॉन्फ़िगर करने के लिए, ब्रैंडिंग की जानकारी, निजता नीति, और सेवा की शर्तें भी सेट करनी होती हैं. ये जानकारी तब दिखती है, जब स्कोप का अनुरोध किया जाता है. इस जानकारी को सार्वजनिक तौर पर पब्लिश करने के लिए, आपको इसे पुष्टि के लिए सबमिट करना होगा.
Google Workspace API को कॉल करने के लिए कोड लिखते समय, JavaScript के लिए क्विकस्टार्ट गाइड को फ़ॉलो करना सबसे आसान तरीका है. इस तरीके में, Google खाते से साइन इन करने की सुविधा और डायलॉग विंडो इस्तेमाल करने के सबसे सही तरीकों का पालन किया जाता है. ध्यान दें कि JavaScript में टोकन क्लाइंट को शुरू करने के लिए, उन स्कोप का अलग से अनुरोध करना ज़रूरी है जिनका इस्तेमाल ऐप्लिकेशन, रनटाइम के दौरान करता है. उपयोगकर्ताओं को बेहतरीन अनुभव देने के लिए, अनुरोध किए गए ये स्कोप, Google Workspace Marketplace के ऐप्लिकेशन कॉन्फ़िगरेशन पेज पर मौजूद स्कोप से मेल खाने चाहिए. इस रिडंडेंसी से, उस स्थिति को हैंडल करने के लिए फ़ॉलबैक मिलता है जिसमें उपयोगकर्ता ने स्कोप रद्द कर दिए हैं.
रखरखाव के सबसे सही तरीके
यहां वेब ऐप्लिकेशन को बनाए रखने के लिए, सबसे सही तरीके बताए गए हैं. हालांकि, ये तरीके Meet के किसी भी ऐड-ऑन को लिखते समय खास तौर पर ज़रूरी होते हैं.
Google Meet ऐड-ऑन SDK टूल का नया वर्शन इस्तेमाल करना
Meet add-ons SDK को समय-समय पर अपडेट किया जाता है. एसडीके, सिमैंटिक वर्शनिंग के मुताबिक है. नया वर्शन ढूंढने के लिए:
- gstatic का इस्तेमाल करते समय: एसडीके का नया वर्शन, gstatic यूआरएल में शामिल होता है. यह यूआरएल, एसडीके इस्तेमाल करने के निर्देशों में मौजूद होता है.
- npm का इस्तेमाल करते समय:
npm update @googleworkspace/meet-add-onsको उस डायरेक्ट्री से चलाएं जिसमें आपकी Meet ऐड-ऑन को होस्ट करने वाली वेबसाइट के लिएpackage.jsonमौजूद है.
स्टेजिंग के लिए Google Cloud प्रोजेक्ट बनाना
Google Meet ऐड-ऑन को Google Workspace Marketplace पर पब्लिश करने के बाद, Google Meet ऐड-ऑन के नए डिप्लॉयमेंट, Meet के उपयोगकर्ताओं के लिए तुरंत उपलब्ध हो जाते हैं. उपयोगकर्ताओं को ये अपडेट तब दिखेंगे, जब वे अपने कैश मेमोरी को खाली करेंगे या कैश मेमोरी की समयसीमा खत्म हो जाएगी. इसलिए, हमारा सुझाव है कि बदलावों को अच्छी तरह से टेस्ट किए जाने तक, उन्हें अपनी प्रोडक्शन साइट पर पुश न करें.
हमारा सुझाव है कि सीधे प्रोडक्शन में डिप्लॉय करने से बचने के लिए, एक अलग Google Cloud प्रोजेक्ट बनाएं. इसे आपके संगठन के लिए निजी तौर पर पब्लिश किया जाता है. यह Cloud प्रोजेक्ट, आपके Meet ऐड-ऑन के लिए स्टेजिंग और डेवलपमेंट, दोनों एनवायरमेंट को होस्ट करेगा. इस Cloud प्रोजेक्ट का ऐक्सेस, सिर्फ़ उस छोटी टीम के पास होना चाहिए जो सीधे तौर पर आपके ऐड-ऑन को डेवलप करने का काम कर रही है.
अपने ऐड-ऑन के लिए ये वैकल्पिक एनवायरमेंट बनाने के लिए, आपको सबसे पहले अपने वेब ऐप्लिकेशन के वैकल्पिक एनवायरमेंट को होस्ट करना होगा. इस वेब ऐप्लिकेशन में आपका ऐड-ऑन शामिल होता है. आपको इसे अपने मालिकाना हक वाले डोमेन पर होस्ट करना होगा. इसके बाद, अपने Meet ऐड-ऑन के लिए अन्य एनवायरमेंट बनाए जा सकते हैं. इसके लिए, अपने स्टेजिंग Google Cloud प्रोजेक्ट में अन्य डिपार्टमेंट जोड़ें. इन नए डिप्लॉयमेंट में ऐसे मेनिफ़ेस्ट होने चाहिए जो आपके वेब ऐप्लिकेशन के दूसरे एनवायरमेंट की ओर इशारा करते हों. इसके बाद, हमारा सुझाव है कि आप हर ऐड-ऑन एनवायरमेंट को इस तरह इंस्टॉल करें:
- स्टेजिंग: स्टेजिंग वर्शन को निजी तौर पर पब्लिश करें, ताकि आपके संगठन का कोई भी व्यक्ति टेस्टिंग में मदद कर सके.
- डेवलपमेंट: सिर्फ़ अपने खाते में Meet ऐड-ऑन का डेवलपमेंट वर्शन इंस्टॉल करने के लिए, कार्रवाइयां कॉलम में जाकर, इंस्टॉल करें पर क्लिक करें.
टेस्ट लिखना
हमारा सुझाव है कि Meet ऐड-ऑन को डेवलपमेंट एनवायरमेंट में डिप्लॉय करने से पहले, यूनिट टेस्ट लिखें. आपकी यूनिट टेस्ट में ये चीज़ें शामिल होनी चाहिए:
- Meet add-ons SDK टूल को मॉक करना. इसके बाद, यह पुष्टि करना कि Meet add-on, एसडीके टूल के फ़ंक्शन को उम्मीद के मुताबिक कॉल करता है.
- अपने पसंदीदा वेब टेस्टिंग फ़्रेमवर्क का इस्तेमाल करके, अपने ऐड-ऑन की एसडीके से जुड़ी सभी सुविधाओं की यूनिट टेस्टिंग करें.
उपयोगकर्ता अनुभव के सबसे सही तरीके
यहां दिए गए सबसे सही तरीकों से, Meet ऐड-ऑन को ज़्यादा सहज और बेहतर बनाया जा सकता है.
साइड पैनल में सभी शुरुआती स्थितियों को मैनेज करना
हमारा सुझाव है कि आप अपने ऐड-ऑन को साइड पैनल में उपयोगकर्ता की कार्रवाइयों के आधार पर सेट अप करें.
इसके लिए, JavaScript में गतिविधि शुरू होने की स्थिति सेट की जाती है. ActivityStartingState में जाने वाले सभी डेटा को, ऐड-ऑन शुरू करने वाले व्यक्ति (आम तौर पर, मीटिंग का होस्ट) को साइड पैनल में सेट करना चाहिए. साइड पैनल के पहले व्यू को एक ऐसे फ़ॉर्म के तौर पर देखा जा सकता है जो आपके ऐड-ऑन के सेटअप को कंट्रोल करता है.
इस्तेमाल न होने पर साइड पैनल बंद करें
startActivity()
तरीके को कॉल करके गतिविधि शुरू करने के बाद, आपको सिर्फ़ तब साइड पैनल खुला रखना चाहिए, जब यह आपके Google Meet ऐड-ऑन के लिए उपयोगकर्ता अनुभव का ज़रूरी हिस्सा हो. मुख्य स्टेज खुलने के बाद, unloadSidePanel() तरीके का इस्तेमाल करके, साइड पैनल को बंद किया जा सकता है.
स्क्रीन शेयर करके, Meet ऐड-ऑन को प्रमोट करना
Meet के ऐड-ऑन, स्क्रीन शेयर करने की सुविधा से ज़्यादा बेहतर अनुभव देते हैं. हालांकि, कई उपयोगकर्ता Meet की स्क्रीन शेयर करने की सुविधा का इस्तेमाल करते हैं. अगर कोई उपयोगकर्ता, Meet ऐड-ऑन होस्ट करने वाली वेबसाइट दिखाने वाला टैब शेयर करता है, तो Meet को इस तरह कॉन्फ़िगर किया जा सकता है कि वह कॉल में हिस्सा लेने वाले सभी लोगों को एक बैनर दिखाए. इस बैनर में, उन्हें Meet ऐड-ऑन इंस्टॉल करने या इस्तेमाल करने के लिए कहा जाएगा. ज़्यादा जानकारी के लिए, स्क्रीन शेयर करके अपने ऐड-ऑन का प्रमोशन करना लेख पढ़ें.
लोगो डिज़ाइन करने से जुड़े दिशा-निर्देश
Meet के लिए लोगो डिज़ाइन करते समय, इन दिशा-निर्देशों का पालन करें, ताकि वह अभी और आने वाले समय में बेहतर दिखे:
PNG फ़ाइल फ़ॉर्मैट का इस्तेमाल करें. इसका साइज़ 256 पिक्सल x 256 पिक्सल होना चाहिए.
पारदर्शिता का इस्तेमाल करें.
Meet ऐड-ऑन के लिए डेवलपर टूल का इस्तेमाल करके, यह पुष्टि करें कि डार्क मोड में आपका लोगो सही दिख रहा है.
कंट्रास्ट चेकर का इस्तेमाल करके, यह पक्का करें कि आपका लोगो (और अन्य ग्राफ़िक ऐसेट) हाई कंट्रास्ट मोड में अच्छी दिख रही हो. इसके लिए, Web Accessibility In Mind (WebAIM) के Contrast Checker जैसे कंट्रास्ट चेकर का इस्तेमाल करें.
ऐप्लिकेशन इंटिग्रेशन के लिए, ग्राफ़िक से जुड़ी ज़रूरी शर्तों का पालन करें.
अपनी इमेज में पैडिंग शामिल न करें. इसके बजाय, इमेज को अपनी फ़ाइल की सीमाओं तक बढ़ाएं.