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