Google Workspace Marketplace SDK टूल में अपना ऐप्लिकेशन कॉन्फ़िगर करें

इस पेज पर, Google Workspace Marketplace SDK टूल का इस्तेमाल करके, Google Workspace Marketplace पर अपने ऐप्लिकेशन को कॉन्फ़िगर और मैनेज करने का तरीका बताया गया है.

अपने ऐप्लिकेशन को इस्तेमाल के लिए उपलब्ध कराने के लिए, आपको उसे Marketplace SDK में सेट अप करना होगा. Marketplace SDK, एक टूलकिट है. इसकी मदद से, Marketplace पर अपना ऐप्लिकेशन बनाया और कंट्रोल किया जा सकता है. Marketplace SDK का इस्तेमाल करके, Marketplace की सेटिंग मैनेज की जाती हैं. जैसे:

• आपका ऐप्लिकेशन किसी खास Google Workspace संगठन (निजी ऐप्लिकेशन) के लिए उपलब्ध है या Marketplace के सभी उपयोगकर्ताओं (सार्वजनिक ऐप्लिकेशन) के लिए उपलब्ध है
• Marketplace के ऐसे उपयोगकर्ताओं के टाइप जो आपका ऐप्लिकेशन इंस्टॉल कर सकते हैं
• आपका ऐप्लिकेशन, Google Workspace के किन ऐप्लिकेशन के साथ इंटिग्रेट होता है
• OAuth के वे स्कोप जिनकी आपके ऐप्लिकेशन को ज़रूरत है
• ऐप्लिकेशन को किसने बनाया और इसे कौन मैनेज करता है, इस बारे में जानकारी

चाहे आपको अपना ऐप्लिकेशन निजी तौर पर पब्लिश करना हो या सार्वजनिक तौर पर, आपको Marketplace SDK टूल का इस्तेमाल करके Marketplace पर अपना ऐप्लिकेशन मैनेज करना होगा.

Marketplace SDK चालू करना

अगर आपने अब तक ऐसा नहीं किया है, तो अपने Google Cloud प्रोजेक्ट में Marketplace SDK चालू करें.

Google Cloud Console में अपना क्लाउड प्रोजेक्ट खोलें

अगर यह पहले से नहीं खुला है, तो उस क्लाउड प्रोजेक्ट को खोलें जिसका इस्तेमाल आपको इस सैंपल के लिए करना है:

1. Google Cloud Console में, कोई प्रोजेक्ट चुनें पेज पर जाएं.

   कोई क्लाउड प्रोजेक्ट चुनें

2. वह Google Cloud प्रोजेक्ट चुनें जिसका आपको इस्तेमाल करना है. इसके अलावा, प्रोजेक्ट बनाएं पर क्लिक करें और स्क्रीन पर दिए गए निर्देशों का पालन करें. Google Cloud प्रोजेक्ट बनाने पर, आपको प्रोजेक्ट के लिए बिलिंग की सुविधा चालू करनी पड़ सकती है.

Marketplace SDK चालू करना

• Google Cloud Console में, Google Workspace Marketplace SDK टूल चालू करें.

  एसडीके टूल चालू करना

अपने ऐप्लिकेशन के लिए कॉन्फ़िगरेशन सेटिंग तय करना

यहां दिए गए रेफ़रंस में, Marketplace SDK के ऐप्लिकेशन कॉन्फ़िगरेशन पेज पर उपलब्ध सेटिंग के बारे में बताया गया है.

चुनें कि आपके ऐप्लिकेशन को कौन देख और इंस्टॉल कर सकता है

ऐप्लिकेशन को कॉन्फ़िगर करते समय, यह तय किया जाता है कि कौनसे उपयोगकर्ता इन सेटिंग का इस्तेमाल करके ऐप्लिकेशन को ऐक्सेस कर सकते हैं:

• ऐप्लिकेशन की उपलब्धता: अगर आपको Google Workspace संगठन में कोई ऐप्लिकेशन पब्लिश करना है, तो आपको यह तय करना होगा कि ऐप्लिकेशन की लिस्टिंग को 'सूची में शामिल नहीं है' के तौर पर सेट करना है या उसे आपके संगठन के सभी उपयोगकर्ताओं या Google Workspace का इस्तेमाल करने वाले किसी भी व्यक्ति को दिखाना है.
• इंस्टॉलेशन सेटिंग: इससे यह तय होता है कि ऐप्लिकेशन को सिर्फ़ Google Workspace एडमिन इंस्टॉल कर सकते हैं या नहीं.

आपने ऐप्लिकेशन की लिस्टिंग में जो भी सेटिंग तय की हैं उनके बावजूद, ऐसा हो सकता है कि Google Workspace संगठन के उपयोगकर्ता आपके ऐप्लिकेशन को खोज, इंस्टॉल या इस्तेमाल न कर पाएं. ऐसा इसलिए, क्योंकि उनके एडमिन ने कुछ सेटिंग सेट की होंगी. एडमिन, आपके ऐप्लिकेशन की उपलब्धता पर इन तरीकों से असर डाल सकते हैं:

• यह कंट्रोल करें कि उनके उपयोगकर्ता, Marketplace पर ऐप्लिकेशन देख सकते हैं या नहीं. साथ ही, यह भी कंट्रोल करें कि वे अपने उपयोगकर्ताओं की ओर से ऐप्लिकेशन इंस्टॉल कर सकते हैं या नहीं.
• अनुमति वाली सूची का इस्तेमाल करके, अपने संगठन के लिए ऐप्लिकेशन मैनेज और क्यूरेट कर सकते हैं. अगर आपको किसी ऐसे संगठन के लिए ऐप्लिकेशन डेवलप करना है जो अनुमति वाली सूचियों का इस्तेमाल करता है, तो एडमिन से संपर्क करके ऐप्लिकेशन को अनुमति वाली सूची में जोड़ने के बारे में जानें.
• Google Workspace के कुछ ऐप्लिकेशन बंद करें. जैसे, Google Chat, Google Chat ऐप्लिकेशन या दोनों का ऐक्सेस हटाना. इन मामलों में, उपयोगकर्ता Marketplace से आपका ऐप्लिकेशन इंस्टॉल नहीं कर पाएंगे.

एडमिन, Marketplace के ऐक्सेस को कैसे मैनेज करते हैं, यह जानने के लिए Marketplace Admin सहायता दस्तावेज़ देखें.

ऐप्लिकेशन दिखने की सेटिंग

अगर Google Workspace खाते (आपके ऑफ़िस या स्कूल के संगठन की ओर से बनाया गया खाता) का इस्तेमाल किया जा रहा है, तो आपको ऐप्लिकेशन दिखने की सेटिंग विकल्प दिखेगा. अगर उपभोक्ता खाते (ऐसा खाता जिसका आखिरी हिस्सा "@gmail.com" है) का इस्तेमाल किया जा रहा है, तो सिर्फ़ सार्वजनिक तौर पर पब्लिश किया जा सकता है.

• सार्वजनिक: आपके डोमेन के बाहर के लोग भी इस ऐप्लिकेशन को ढूंढकर इंस्टॉल कर सकते हैं. सार्वजनिक तौर पर दिखने का विकल्प चुनने पर, Google आपके ऐप्लिकेशन की समीक्षा करता है और उसे मंज़ूरी देता है. इसके बाद ही, उसे पब्लिश किया जाता है.
• निजी: सिर्फ़ आपके डोमेन के लोग, आपके ऐप्लिकेशन को ढूंढकर इंस्टॉल कर सकते हैं.

निजी के तौर पर सेट किया गया विकल्प चुनने पर, ऐप्लिकेशन की लिस्टिंग ब्राउज़ करने या खोज के नतीजों में नहीं दिखती. उपयोगकर्ता, ऐप्लिकेशन के स्टोर पेज को सिर्फ़ डायरेक्ट यूआरएल से ऐक्सेस कर सकते हैं.

अगर आपको यह तय करना है कि आपका ऐप्लिकेशन किन देशों और इलाकों में उपलब्ध हो, तो स्टोर पेज बनाते समय वितरण सेक्शन में जाकर, यह तय करें.

ऐप्लिकेशन इंस्टॉल करने की सेटिंग

इंस्टॉलेशन सेटिंग विकल्प से यह तय होता है कि उपयोगकर्ता या Google Workspace एडमिन, Marketplace पर मौजूद स्टोर लिस्टिंग पेज से आपका ऐप्लिकेशन इंस्टॉल कर सकते हैं या नहीं.

• व्यक्तिगत + एडमिन के तौर पर इंस्टॉल करना (डिफ़ॉल्ट): इस ऐप्लिकेशन को व्यक्तिगत उपयोगकर्ता इंस्टॉल कर सकते हैं. इसके अलावा, एडमिन अपने डोमेन, संगठन की इकाई या उपयोगकर्ताओं के ग्रुप के लिए भी इसे इंस्टॉल कर सकते हैं. उपयोगकर्ता के डोमेन की नीतियों की वजह से, उसे ऐप्लिकेशन इंस्टॉल करने से रोका जा सकता है. भले ही, अलग-अलग इंस्टॉल करने की सुविधा चालू हो.
• सिर्फ़ एडमिन के लिए इंस्टॉल करने का विकल्प: इस ऐप्लिकेशन को सिर्फ़ एडमिन अपने डोमेन, संगठन की इकाई या उपयोगकर्ताओं के ग्रुप के लिए इंस्टॉल कर सकते हैं. आपका ऐप्लिकेशन, Google Workspace Marketplace पर सिर्फ़ एडमिन और उन लोगों के लिए खोज के नतीजों में दिखता है जिन्होंने अपने Google खाते में लॉग इन नहीं किया है. अगर आपके ऐप्लिकेशन के लिए डोमेन इंस्टॉल करना ज़रूरी है, तो यह विकल्प चुनें.

इंस्टॉल करने और दिखने की सामान्य सेटिंग

यहां दी गई टेबल में, ऐप्लिकेशन को इंस्टॉल करने और उसे दिखाने के लिए, ऐप्लिकेशन कॉन्फ़िगरेशन के कुछ सामान्य विकल्पों के बारे में खास जानकारी दी गई है:

यह पता लगाना कि आपका ऐप्लिकेशन, Google Workspace के ऐप्लिकेशन के साथ कैसे इंटिग्रेट होता है

ऐप्लिकेशन इंटिग्रेशन विकल्प की मदद से, Google Workspace की उन सेवाओं को चुना जा सकता है जिनके साथ आपका ऐप्लिकेशन या ऐड-ऑन काम करने के लिए डिज़ाइन किया गया है. जैसे, Google Workspace ऐड-ऑन या Google Chat ऐप्लिकेशन. आपको कम से कम एक विकल्प चुनना होगा. कुछ मामलों में, ऐप्लिकेशन की लिस्टिंग में एक से ज़्यादा ऐप्लिकेशन इंटिग्रेशन शामिल किए जा सकते हैं. ऐप्लिकेशन इंटिग्रेशन की सूची एक साथ देखना लेख पढ़ें.

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

• Unsaved: आपने कोई इंटिग्रेशन जोड़ा है या उसमें बदलाव किया है. हालांकि, आपने ऐप्लिकेशन कॉन्फ़िगरेशन टैब पर बदलाव सेव नहीं किए हैं.
• Draft: आपके बदलाव सेव हो गए हैं, लेकिन उन्हें पब्लिश नहीं किया गया है.
• Under review: आपने समीक्षा के लिए, ऐप्लिकेशन इंटिग्रेशन का अपडेट किया गया वर्शन सबमिट किया है.
• Published: ऐप्लिकेशन इंटिग्रेशन को Marketplace की लिस्टिंग में शामिल किया गया है.

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

यह बताएं कि आपके ऐप्लिकेशन को किस लेवल के ऐक्सेस की ज़रूरत है

OAuth के दायरे में जाकर, OAuth 2.0 के उन सभी दायरों की पूरी सूची दें जिनकी आपके ऐप्लिकेशन को ज़रूरत है. यहां डाले गए OAuth के स्कोप, OAuth के लिए सहमति की स्क्रीन में दिखाए गए स्कोप से मेल खाने चाहिए. साथ ही, अगर लागू हो, तो Apps Script मेनिफ़ेस्ट में दिखाए गए स्कोप से भी मेल खाने चाहिए.

अगर आपने एक से ज़्यादा ऐप्लिकेशन इंटिग्रेशन शामिल किए हैं, तो पक्का करें कि आपने हर ऐप्लिकेशन के स्कोप को Marketplace SDK के ऐप्लिकेशन कॉन्फ़िगरेशन पेज और OAuth सहमति स्क्रीन पर जोड़ा हो.

हमेशा सबसे छोटे स्कोप का इस्तेमाल करें. उदाहरण के लिए, अगर आपको सिर्फ़ पढ़ने के लिए स्कोप की ज़रूरत है, तो पूरे Drive स्कोप को शामिल न करें.

Apps Script प्रोजेक्ट के लिए, ज़्यादा जानकारी के लिए अनुमति के स्कोप देखें.

ऐप्लिकेशन डेवलपर के बारे में जानकारी देना

डेवलपर की जानकारी में जाकर, संपर्क जानकारी और अन्य जानकारी भरें. ये फ़ील्ड, आपके ऐप्लिकेशन के स्टोर पेज पर दिखते हैं.

Marketplace SDK में, ऐप्लिकेशन कॉन्फ़िगरेशन की सेटिंग सेव करना

पिछले सेक्शन में दी गई जानकारी का इस्तेमाल करके, Marketplace SDK में अपने ऐप्लिकेशन का कॉन्फ़िगरेशन सेव करें:

1. Google Cloud Console में, Marketplace SDK ऐप्लिकेशन कॉन्फ़िगरेशन पेज पर जाएं:

   Marketplace SDK कॉन्फ़िगरेशन पेज पर जाएं

2. हर सेक्शन में, पिछले सेक्शन में तय की गई जानकारी के हिसाब से जवाब दें.

3. ड्राफ़्ट सेव करें पर क्लिक करें.

4. (ज़रूरी नहीं) Google Analytics में, ऐप्लिकेशन के इस्तेमाल से जुड़े आंकड़े पाए जा सकते हैं. इसके लिए, Marketplace SDK में Google Analytics आईडी जोड़ें.

   1. Analytics टैब पर जाएं.
   2. अपना Google Analytics आईडी डालें.
   3. सेव करें पर क्लिक करें.

समस्या हल करें

इस सेक्शन में, आम तौर पर होने वाली समस्याओं के बारे में बताया गया है.

Marketplace पर ऐप्लिकेशन पब्लिश करते समय, ज़रूरी अनुमतियां मौजूद नहीं हैं

Marketplace पर ऐप्लिकेशन पब्लिश नहीं किए जा सकते, क्योंकि Marketplace SDK के ऐप्लिकेशन कॉन्फ़िगरेशन पेज पर ऐप्लिकेशन को कॉन्फ़िगर करने की कोशिश करने पर, यह गड़बड़ी का मैसेज दिखता है:

You are missing at least one of the following required permissions: Project workspacemarketplace.appconfiguration.view / workspacemarketplace.appconfiguration.update

यह गड़बड़ी तब होती है, जब Marketplace SDK API चालू हो और Editor या Owner के अलावा किसी अन्य IAM भूमिका का इस्तेमाल किया जा रहा हो.

गड़बड़ी को ठीक करने के लिए, इनमें से कोई एक तरीका अपनाएं:

• प्रोजेक्ट के मालिक से अनुरोध करें कि वह उस खाते को roles/appmetadata.workspaceMarketplaceAppConfigurationAdmin भूमिका असाइन करे जिसके पास ज़रूरी अनुमतियां नहीं हैं. इससे वह खाता, Marketplace SDK में ऐप्लिकेशन को कॉन्फ़िगर और मैनेज कर पाएगा.

• प्रोजेक्ट के मालिक से कहें कि वह Google Cloud Console में, आईएएम और एडमिन > भूमिकाएं पेज पर जाकर, कस्टम भूमिका में छूटी हुई अनुमतियां जोड़ दे. इसके बाद, जिस खाते के पास ज़रूरी अनुमतियां नहीं हैं उसे कस्टम भूमिका असाइन करें.

• ऐप्लिकेशन पब्लिश करने के लिए, प्रिमिटिव roles/editor या roles/owner का इस्तेमाल किया जा सकता है. हालांकि, IAM का सुरक्षित तरीके से इस्तेमाल करें दस्तावेज़ में इसे सही तरीका नहीं माना गया है, क्योंकि प्रोजेक्ट में मौजूद अन्य संसाधनों के लिए, बदलाव करने का ऐक्सेस आसानी से सीमित नहीं किया जा सकता.