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

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

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

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

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

Marketplace SDK टूल चालू करना

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

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

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

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

    कोई Cloud प्रोजेक्ट चुनना

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

Google Workspace Marketplace SDK टूल चालू करें

Google API का इस्तेमाल करने से पहले, आपको उन्हें Google Cloud प्रोजेक्ट में चालू करना होगा. किसी एक Google Cloud प्रोजेक्ट में, एक या उससे ज़्यादा एपीआई चालू किए जा सकते हैं.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Google Workspace ऐड-ऑन (Apps Script)

Google Workspace ऐड-ऑन पब्लिश करने के लिए, आपको ऐड-ऑन का डिप्लॉयमेंट आईडी देना होगा. डिप्लॉयमेंट आईडी ढूंढने के लिए, यह तरीका अपनाएं:

  1. Apps Script एडिटर में अपना Google Workspace ऐड-ऑन खोलें.
  2. डिप्लॉय करें > डिप्लॉयमेंट मैनेज करें पर क्लिक करें.
  3. डिप्लॉयमेंट आईडी में जाकर, कॉपी करें पर क्लिक करें.

Google Workspace ऐड-ऑन (एचटीटीपी डिप्लॉयमेंट)

अगर आपने एचटीटीपी एंडपॉइंट का इस्तेमाल करके Google Workspace ऐड-ऑन बनाया है, तो Google Cloud के डिप्लॉयमेंट रिसॉर्स से, डिप्लॉयमेंट आईडी पाने के लिए यह तरीका अपनाएं.

  1. "Google Workspace ऐड-ऑन" में मौजूद ऐप्लिकेशन कॉन्फ़िगरेशन पेज पर, एचटीटीपी या अन्य डिप्लॉयमेंट > डिप्लॉयमेंट चुनें पर क्लिक करें.
  2. वह डिप्लॉयमेंट चुनें जिसे पब्लिश करना है.
  3. चुनें पर क्लिक करें.

Editor ऐड-ऑन (Docs, Sheets, Slides, Forms)

एडिटर ऐड-ऑन को पब्लिश करने के लिए, आपको वह प्रोजेक्ट स्क्रिप्ट आईडी और वर्शन देना होगा जिसे पब्लिश करना है.

प्रोजेक्ट स्क्रिप्ट आईडी ढूंढने के लिए, यह तरीका अपनाएं:

  1. Apps Script एडिटर में ऐड-ऑन खोलें.
  2. बाईं ओर, प्रोजेक्ट सेटिंग पर क्लिक करें.
  3. "आईडी" में जाकर, स्क्रिप्ट आईडी कॉपी करें.

वर्शन ढूंढने के लिए, यह तरीका अपनाएं:

  1. Apps Script एडिटर में ऐड-ऑन खोलें.
  2. सबसे ऊपर दाईं ओर, डिप्लॉय करें > डिप्लॉयमेंट मैनेज करें पर क्लिक करें.
  3. वर्शन नंबर, "कॉन्फ़िगरेशन" में दिखता है.

Google Chat ऐप्लिकेशन

Google Chat ऐप्लिकेशन पब्लिश करने के लिए, आपको Google Chat API को कॉन्फ़िगर करना होगा. Google Chat ऐप्लिकेशन पब्लिश करना देखें.

Drive ऐप्लिकेशन

Drive ऐप्लिकेशन पब्लिश करने के लिए, आपको Google Drive API को चालू और कॉन्फ़िगर करना होगा.

वेब ऐप्लिकेशन

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

स्टोर पेज भरते समय, आपको 96x96 और 48x48 पिक्सल के अतिरिक्त आइकॉन देने होंगे.

अगर आपने अपना वेब ऐप्लिकेशन Apps Script में बनाया है, तो यूनिवर्सल नेविगेशन यूआरएल पाने के लिए यह तरीका अपनाएं:

  1. Apps Script एडिटर में, अपना Google Workspace ऐड-ऑन खोलें.
  2. डिप्लॉय करें > नया डिप्लॉयमेंट पर क्लिक करें.
  3. "टाइप चुनें" में जाकर, वेब ऐप्लिकेशन पर क्लिक करें.
  4. विकल्पों को भरें और डिप्लॉय करें पर क्लिक करें.
  5. कॉपी करें पर क्लिक करें.

यह बताएं कि आपके ऐप्लिकेशन को किस लेवल का ऐक्सेस चाहिए

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

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

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

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

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

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

फ़ील्ड
व्यापारी या कंपनी की स्थिति

उपभोक्ता संरक्षण कानूनों की वजह से, यूरोपियन इकनॉमिक एरिया (ईईए) में रहने वाले उपभोक्ताओं को यह बताना ज़रूरी है कि Google Workspace Marketplace पर मौजूद कोई कारोबारी, व्यापारी है या गैर-व्यापारी:

  • व्यापारी: व्यापारी वह व्यक्ति होता है जो किसी व्यापार, कारोबार, कला या व्यवसाय से जुड़ी गतिविधियों में हिस्सा लेता है. इसके अलावा, वह किसी व्यापारी के नाम पर या उसकी ओर से भी काम कर सकता है.
  • गैर-व्यापारी: गैर-व्यापारी (उपभोक्ता) वह व्यक्ति होता है जो पेशेवर तौर पर काम नहीं करता.

अगर इसकी जानकारी नहीं दी जाती है, तो आपके ऐप्लिकेशन के स्टोर पेज पर "डेवलपर के व्यापारी होने या न होने की जानकारी नहीं है" दिखता है.

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

व्यापारियों के लिए ज़रूरी है. यह जानकारी, कारोबारी या कंपनी के तौर पर रजिस्टर नहीं किए गए लोगों के लिए इकट्ठा नहीं की जाती.

आपके कारोबार की जगह की जानकारी. कोई मान्य मेलिंग पता डालें, ताकि आपसे संपर्क किया जा सके.

डेवलपर की वेबसाइट का यूआरएल वह वेबसाइट जिस पर आपके (या आपके संगठन के) डेवलपर के तौर पर जानकारी दी गई हो.
डेवलपर का ईमेल पता

संपर्क के तौर पर इस्तेमाल किया जाने वाला ईमेल पता. यह जानकारी, आपकी ऐप लिस्टिंग में शामिल नहीं होती. पक्का करें कि यह ईमेल पता अप-टू-डेट हो, क्योंकि इसका इस्तेमाल किया जा रहा है:

  • अगर Google को डेवलपर से संपर्क करना हो. उदाहरण के लिए, ऐप्लिकेशन की समीक्षा की प्रोसेस के दौरान.
  • अगर स्टोर पेज पर रिपोर्ट से जुड़ी समस्या का यूआरएल नहीं दिया गया है, तो एडिटर ऐड-ऑन से सुझाव, शिकायत या राय भेजने के लिए.
ऐप्लिकेशन की वेबसाइट का यूआरएल ज़रूरी नहीं. वह वेबसाइट जो आपके ऐप्लिकेशन के बारे में ज़्यादा जानकारी देती है.

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

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

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

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

  2. पिछले सेक्शन में दी गई जानकारी के आधार पर हर सेक्शन में जानकारी भरें.

  3. सेव करें पर क्लिक करें.

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

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