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

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

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

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

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

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

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

• स्टैजिंग: स्टैजिंग वर्शन को निजी तौर पर पब्लिश करें ताकि आपके संगठन का कोई भी व्यक्ति टेस्टिंग में मदद कर सके.
• डेवलपमेंट: 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 के ऐड-ऑन के लिए डेवलपर टूल का इस्तेमाल करके, यह पुष्टि करें कि डार्क मोड में आपका लोगो अच्छा दिखता है या नहीं.

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

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

मिलते-जुलते विषय

• Meet के ऐड-ऑन से जुड़ी समस्याओं को हल करना