सबसे सही तरीके

Google Meet के ऐड-ऑन के डिज़ाइन के लिए, इन गाइड को पढ़कर अपने उपयोगकर्ताओं के अनुभव को बेहतर बनाएं.

अनुमति देने के सबसे सही तरीके

हमारा सुझाव है कि पुष्टि करने या अनुमति देने की सुविधा वाले Google Meet के किसी भी ऐड-ऑन के लिए, यहां दिए गए सबसे सही तरीके अपनाएं.

Google साइन-इन का इस्तेमाल करना

Google Workspace ऐड-ऑन का इस्तेमाल करने वाले कई उपयोगकर्ता, मीटिंग में शामिल होने से पहले ही Google में साइन इन कर चुके होंगे. इसलिए, Google One Tap को विकल्प के तौर पर उपलब्ध कराने से, साइन-इन करने की प्रोसेस के दौरान उपयोगकर्ताओं को कई क्लिक करने से बचाया जा सकता है. ज़्यादा जानकारी के लिए, अपने ऐड-ऑन के लिए साइन-इन करने के तरीके मैनेज करना लेख पढ़ें.

तीसरे पक्ष के साइन-इन पेज को नई विंडो में खोलें

Google से साइन इन करने के अलावा, आपका ऐप्लिकेशन साइन इन करने के अन्य तरीके भी उपलब्ध करा सकता है. अगर ऐसा है, तो नए टैब में साइन-इन पेज खोलने के बजाय, डायलॉग विंडो का इस्तेमाल करें. इस तरह, उपयोगकर्ता अब भी Meet कॉल देख सकता है और उस पर वापस जा सकता है. साथ ही, उसे कम क्लिक करने पड़ेंगे.

Google APIs के लिए स्कोप का सही तरीके से अनुरोध करना

अगर आपका 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 ऐड-ऑन एसडीके को समय-समय पर अपडेट किया जाता है. एसडीके, सिमैंटिक वर्शनिंग के सिद्धांत का पालन करता है. नया वर्शन ढूंढने के लिए:

  • gstatic का इस्तेमाल करते समय: एसडीके का नया वर्शन, gstatic यूआरएल में शामिल होता है. यह यूआरएल, एसडीके इस्तेमाल करने के निर्देशों में मौजूद होता है.
  • npm का इस्तेमाल करते समय: npm update @googleworkspace/meet-add-ons को उस डायरेक्ट्री से चलाएं जिसमें आपकी वेबसाइट के लिए package.json मौजूद है. यह वेबसाइट, Meet ऐड-ऑन को होस्ट करती है.

स्टेजिंग के लिए Google Cloud प्रोजेक्ट बनाना

Google Workspace Marketplace पर Google Meet ऐड-ऑन पब्लिश होने के बाद, Google Meet ऐड-ऑन के नए डिप्लॉयमेंट, Meet उपयोगकर्ताओं के लिए तुरंत उपलब्ध हो जाते हैं. उपयोगकर्ताओं को ये अपडेट तब दिखेंगे, जब वे अपने कैश मेमोरी को खाली करेंगे या कैश मेमोरी की समयसीमा खत्म हो जाएगी. इसलिए, हमारा सुझाव है कि बदलावों को अच्छी तरह से टेस्ट करने के बाद ही, उन्हें प्रोडक्शन साइट पर लागू करें.

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

अपने ऐड-ऑन के लिए ये वैकल्पिक एनवायरमेंट बनाने के लिए, आपको सबसे पहले अपने वेब ऐप्लिकेशन के वैकल्पिक एनवायरमेंट को ऐसे डोमेन पर होस्ट करना होगा जिसका मालिकाना हक आपके पास हो. इस वेब ऐप्लिकेशन में आपका ऐड-ऑन शामिल होना चाहिए. इसके बाद, अपने Meet ऐड-ऑन के लिए अन्य एनवायरमेंट बनाए जा सकते हैं. इसके लिए, अपने स्टेजिंग Google क्लाउड प्रोजेक्ट में अन्य डिप्लॉयमेंट जोड़ें. इन नए डिप्लॉयमेंट में ऐसे मेनिफ़ेस्ट होने चाहिए जो आपके वेब ऐप्लिकेशन के दूसरे एनवायरमेंट की ओर इशारा करते हों. इसके बाद, हमारा सुझाव है कि आप हर ऐड-ऑन एनवायरमेंट को इस तरह इंस्टॉल करें:

  • स्टेजिंग: स्टेजिंग वर्शन को निजी तौर पर पब्लिश करें, ताकि आपके संगठन का कोई भी व्यक्ति टेस्टिंग में मदद कर सके.
  • डेवलपमेंट: सिर्फ़ अपने खाते में 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.

ऐप्लिकेशन इंटिग्रेशन के लिए, ग्राफ़िक से जुड़ी ज़रूरी शर्तों का पालन करें.

अपनी इमेज में पैडिंग शामिल न करें. इसके बजाय, इमेज को अपनी फ़ाइल की सीमाओं तक बढ़ाएं.