सर्वोत्तम प्रक्रियाएं

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

रखरखाव के सबसे सही तरीके

यहां बताए गए सबसे सही तरीके, ऐसे वेब ऐप्लिकेशन लिखने के लिए हैं जिन्हें आसानी से मैनेज किया जा सकता है. हालांकि, ये तरीके Meet के ऐड-ऑन लिखते समय खास तौर पर अहम होते हैं.

Google Meet के ऐड-ऑन SDK टूल का नया वर्शन इस्तेमाल करना

Meet ऐड-ऑन SDK टूल को नियमित तौर पर अपडेट किया जाता है. SDK टूल, सेमांटिक वर्शनिंग का पालन करता है. नया वर्शन ढूंढने के लिए:

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

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

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

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

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

  • स्टैजिंग: स्टैजिंग वर्शन को निजी तौर पर पब्लिश करें ताकि आपके संगठन का कोई भी व्यक्ति टेस्टिंग में मदद कर सके.
  • डेवलपमेंट: Meet ऐड-ऑन के डेवलपमेंट वर्शन को सिर्फ़ अपने खाते में इंस्टॉल करने के लिए, कार्रवाइयां कॉलम में जाकर इंस्टॉल करें पर क्लिक करें.

टेस्ट लिखना

हमारा सुझाव है कि Meet ऐड-ऑन को डेवलपमेंट एनवायरमेंट में डिप्लॉय करने से पहले, यूनिट टेस्ट लिखें. आपकी यूनिट टेस्ट में ये चीज़ें शामिल होनी चाहिए:

  • Meet के ऐड-ऑन के SDK टूल को मॉक करना और फिर पुष्टि करना कि Meet ऐड-ऑन, SDK टूल के फ़ंक्शन को उम्मीद के मुताबिक कॉल करता है.
  • अपने पसंदीदा वेब टेस्टिंग फ़्रेमवर्क की मदद से, ऐड-ऑन की उन सभी सुविधाओं की यूनिट टेस्टिंग करना जो SDK टूल से जुड़ी नहीं हैं.

उपयोगकर्ता अनुभव के लिए सबसे सही तरीके

Meet ऐड-ऑन को ज़्यादा आसान और बेहतर बनाने के लिए, यहां दिए गए सबसे सही तरीके अपनाएं.

साइड पैनल में, सभी पैनल की शुरुआती स्थिति मैनेज करना

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

इस्तेमाल में न होने पर साइड पैनल बंद कर दें

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

स्क्रीन शेयर करके, Meet के लिए बनाए गए अपने ऐड-ऑन का प्रमोशन करना

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

लोगो डिज़ाइन के लिए दिशा-निर्देश

Meet के लिए लोगो डिज़ाइन करते समय, इन दिशा-निर्देशों का पालन करें, ताकि वह अब और आने वाले समय में भी बेहतर दिखे:

PNG फ़ाइल फ़ॉर्मैट का इस्तेमाल करें. इसका साइज़ 256 x 256 पिक्सल होना चाहिए.

पारदर्शिता का इस्तेमाल करें.

Meet के ऐड-ऑन के लिए डेवलपर टूल का इस्तेमाल करके, यह पुष्टि करें कि डार्क मोड में आपका लोगो अच्छा दिखता है या नहीं.

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

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