पब्लिश किए गए ऐड-ऑन को अपग्रेड करना

ज़्यादा जानकारी के लिए, क्या एडिटर ऐड-ऑन को अपग्रेड किया जा सकता है लेख पढ़ें.

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

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

ध्यान दें: अगर आपने Gmail ऐड-ऑन और Calendar कॉन्फ़्रेंसिंग ऐड-ऑन को अपग्रेड नहीं किया, तो वे सामान्य होम पेज वाले Google Workspace ऐड-ऑन में अपने-आप अपग्रेड हो जाएंगे. आपकी लिस्टिंग या डेवलपर कोड में कोई बदलाव करने की ज़रूरत नहीं है. यह ऐड-ऑन सिर्फ़ इसके ओरिजनल होस्ट ऐप्लिकेशन में उपलब्ध होगा. Google Workspace Marketplace में, अपने-आप अपग्रेड होने वाले ऐड-ऑन “Gmail के साथ काम करता है” या “Calendar के साथ काम करता है” सेक्शन में दिखते हैं. इनमें स्टोर पेज, इंस्टॉल, और उपयोगकर्ता बनाए रखने की जानकारी होती है.

पहला चरण: अपने ऐड-ऑन के Apps Script प्रोजेक्ट की कॉपी बनाना

अपग्रेड किया गया ऐड-ऑन, आपके पब्लिश किए गए ऐड-ऑन के Google Cloud प्रोजेक्ट का ही इस्तेमाल करता है. लेकिन, मौजूदा Apps Script प्रोजेक्ट की एक कॉपी बनाना और उसका इस्तेमाल करना ज़रूरी है. इससे, अपग्रेड किए गए वर्शन को टेस्ट करते समय आपके मौजूदा उपयोगकर्ताओं पर कोई असर नहीं पड़ेगा. ओरिजनल स्क्रिप्ट प्रोजेक्ट की एक कॉपी को अपग्रेड करने का मतलब यह भी है कि ओरिजनल कोड को कभी भी ऐक्सेस किया जा सकता है. साथ ही, ज़रूरत पड़ने पर, बाद में उसे दोबारा डिप्लॉय किया जा सकता है.

1. अपना मौजूदा Gmail ऐड-ऑन या Calendar कॉन्फ़्रेंसिंग ऐड-ऑन Apps Script प्रोजेक्ट खोलें.
2. बाईं ओर, खास जानकारी पर क्लिक करें.
3. दाईं ओर, 'कॉपी बनाएं' पर क्लिक करें.
4. बाईं ओर, प्रोजेक्ट सेटिंग > प्रोजेक्ट बदलें पर क्लिक करें.
5. GCP प्रोजेक्ट नंबर पर क्लिक करें.
6. वही प्रोजेक्ट नंबर डालें जो आपके मौजूदा और पब्लिश किए गए ऐड-ऑन Apps Script प्रोजेक्ट से जुड़ा है.
7. प्रोजेक्ट सेट करें पर क्लिक करें.

चेतावनी: किसी सार्वजनिक ऐड-ऑन के Apps Script प्रोजेक्ट को सीधे अपग्रेड न करें. आपको अपग्रेड किए गए वर्शन को बनाने और टेस्ट किए जाने के दौरान उसकी कॉपी बनाकर उसे सार्वजनिक वर्शन से अलग रखना होगा.

दूसरा चरण: Google Workspace ऐड-ऑन को इंटिग्रेट करना

आपको Google Workspace की जिन ऐड-ऑन सुविधाओं को ऐड-ऑन में जोड़ना है उन्हें डिज़ाइन और लागू करना होगा.

1. तय करें कि ऐड-ऑन के होम पेज कार्ड में कौनसा कॉन्टेंट दिखाया जाए. साथ ही, यह भी तय करें कि क्या वे Gmail, Calendar, Drive या तीनों होस्ट के किसी कॉम्बिनेशन में दिखें. अगर आपको एक से ज़्यादा होस्ट पर होम पेज चाहिए, तो यह तय करें कि क्या यह एक ही होम पेज हो सकता है या आपको हर होस्ट के लिए पसंद के मुताबिक होम पेज कार्ड चाहिए.
2. कॉपी किए गए ऐड-ऑन Apps Script प्रोजेक्ट में, homepageTrigger फ़ंक्शन की मदद से अपना होम पेज कार्ड बनाएं. अपने नए होम पेज इंटरफ़ेस को कंट्रोल करने के लिए, ज़रूरी सभी फ़ंक्शन या लॉजिक को शामिल करना न भूलें.

3. उपयोगकर्ता की कार्रवाई से ट्रिगर हुए काम के कार्ड जोड़ें, जैसे कि Gmail मैसेज थ्रेड या कैलेंडर इवेंट खोलना.

   चेतावनी: अपग्रेड किए गए ऐड-ऑन को मिलने वाले आईडी की वैल्यू, Gmail ऐड-ऑन की तुलना में Gmail मैसेज के लिए अलग होती है. इस बदलाव का असर सिर्फ़ अपग्रेड किए गए उन ऐड-ऑन पर पड़ेगा जो messageId को किसी भी स्थायी स्टोरेज वाली कुंजी के तौर पर इस्तेमाल करेंगे. ज़रूरत पड़ने पर, अब भी Gmail API का इस्तेमाल करके, आईडी की पुरानी वैल्यू पाई जा सकती हैं. Gmail API के messages().get() तरीके में, नए और पुराने, दोनों तरह के आईडी की वैल्यू इस्तेमाल की जा सकती हैं. हालांकि, यह आईडी के लिए सिर्फ़ पुरानी वैल्यू दिखाता है.

4. अपडेट किए गए इवेंट ऑब्जेक्ट स्ट्रक्चर का इस्तेमाल करने के लिए, अपने ऐड-ऑन (विजेट कॉलबैक फ़ंक्शन या कॉन्टेक्स्चुअल ट्रिगर फ़ंक्शन में) में इवेंट ऑब्जेक्ट के किसी भी ऐक्सेस को अपडेट करें. इस नए स्ट्रक्चर में अब भी वही इवेंट ऑब्जेक्ट फ़ील्ड हैं जिनका इस्तेमाल Gmail और Calendar कॉन्फ़्रेंसिंग ऐड-ऑन करते हैं. हालांकि, उन मूल फ़ील्ड के इस्तेमाल पर रोक लगा दी जाती है और बाद में उन्हें हटा दिया जाता है.

तीसरा चरण: अपने ऐड-ऑन का मेनिफ़ेस्ट अपडेट करना

Google Workspace ऐड-ऑन के मेनिफ़ेस्ट स्ट्रक्चर में कॉन्फ़िगरेशन की जानकारी को सेव करने का तरीका काफ़ी बदल गया है. अब इसमें, Gmail ऐड-ऑन और Calendar कॉन्फ़्रेंसिंग ऐड-ऑन के इस्तेमाल की प्रोसेस बदल गई है. अपना ऐड-ऑन अपग्रेड करते समय, आपको अपने ऐड-ऑन के Apps Script प्रोजेक्ट के मेनिफ़ेस्ट फ़ील्ड को नीचे दी गई टेबल के मुताबिक अपडेट करना होगा. आपको काम की सभी सब-प्रॉपर्टी को नई addOns प्रॉपर्टी में अपडेट करना होगा.

अपडेट किए गए ऐड-ऑन के लिए ज़रूरी अनुमतियां दिखाने के लिए, अपने मेनिफ़ेस्ट का oauthScopes फ़ील्ड भी अपडेट करना न भूलें.

Google Workspace ऐड-ऑन मेनिफ़ेस्ट के बारे में ज़्यादा जानने के लिए, मेनिफ़ेस्ट देखें.

Gmail ऐड-ऑन

ओरिजनल मेनिफ़ेस्ट फ़ील्ड	कार्रवाई ज़रूरी है
gmail.composeTrigger	addOns.gmail.composeTrigger में ले जाएं.
gmail.contextualTriggers[]	सूची को addOns.gmail.contextualTriggers[] में ले जाएं.
gmail.logoUrl	addOns.common.logoUrl में ले जाएं.
gmail.name	addOns.common.name में ले जाएं.
gmail.openLinkUrlPrefixes[]	सूची को addOns.common.openLinkUrlPrefixes[] में ले जाएं.
gmail.primaryColor	addOns.common.layoutProperties.primaryColor में ले जाएं.
gmail.secondaryColor	addOns.common.layoutProperties.secondaryColor में ले जाएं.
gmail.universalActions[]	सूची को addOns.common.universalActions[] में ले जाएं.
gmail.universalActions[].text	हर gmail.universalActions[].text फ़ील्ड को उससे जुड़े addOns.common.universalActions[].label फ़ील्ड में ले जाएं.
gmail.useLocalFromApp	addOns.common.useLocaleFromApp में ले जाएं.

Calendar पर कॉन्फ़्रेंसिंग के ऐड-ऑन

ओरिजनल मेनिफ़ेस्ट फ़ील्ड	कार्रवाई ज़रूरी है
calendar.createSettingsUrlFunction	addOns.calendar.createSettingsUrlFunction में ले जाएं.
calendar.conferenceSolution[]	addOns.calendar.conferenceSolution[] में ले जाएं.
calendar.logoUrl	addOns.common.logoUrl में ले जाएं.
calendar.name	addOns.common.name में ले जाएं.

चौथा चरण: अपग्रेड किए गए ऐड-ऑन को टेस्ट करना

पब्लिश करने से पहले, अपग्रेड किए गए ऐड-ऑन की जांच करने के लिए, Google Workspace ऐड-ऑन की जांच करना लेख पढ़ें.

पांचवां चरण: अपग्रेड किए गए ऐड-ऑन की समीक्षा का अनुरोध करना

Google Workspace के सभी ऐड-ऑन को Google Workspace Marketplace पर शामिल करने से पहले, उनके लिए अनुमति लेनी होगी. भले ही, अपग्रेड किया गया कोई ऐड-ऑन या नए सिरे से बनाया गया ऐड-ऑन हो.

अपने ऐड-ऑन को समीक्षा के लिए सबमिट करने के लिए इन चरणों का पालन करें:

1. पक्का करें कि आपका ऐड-ऑन, ऐड-ऑन पब्लिश करने से जुड़ी सभी ज़रूरी शर्तें पूरी करता है.

2. आपको जिस कोड को पब्लिश करना है उसके वर्शन का इस्तेमाल करके, अपने Google Workspace ऐड-ऑन (नए Apps Script प्रोजेक्ट में) का वर्शन का डिप्लॉयमेंट करें. हेड डिप्लॉयमेंट का इस्तेमाल करके पब्लिश करने की कोशिश न करें.

3. अगर आपने ऐड-ऑन अपग्रेड करते समय नए दायरे जोड़े हैं, तो आपको OAuth की पुष्टि करने का अनुरोध करना होगा. उदाहरण के लिए, अगर आपके Gmail ऐड-ऑन में, Google Workspace ऐड-ऑन वर्शन में Drive या Calendar के नए स्कोप का इस्तेमाल किया गया है, तो आपको पुष्टि के लिए उन नए दायरों को सबमिट करना होगा. पुष्टि की प्रोसेस को पूरा होने में अक्सर कुछ दिन लगते हैं. इसलिए, जल्द से जल्द पुष्टि की प्रक्रिया शुरू करें. छठे चरण पर जाने से पहले, पक्का करें कि आपके ऐड-ऑन की पुष्टि हो चुकी हो.

छठा चरण: अपग्रेड किया गया ऐड-ऑन उपलब्ध कराना

1. Google Workspace Marketplace SDK टूल खोलें.

2. बाईं ओर, कॉन्फ़िगरेशन पर क्लिक करें. इस पैनल में एक फ़ॉर्म होगा, जिसमें ऐड-ऑन के बारे में जानकारी दी जाएगी.

3. Google Workspace ऐड-ऑन की नई सुविधाओं के बारे में बताने के लिए, अपनी लिस्टिंग की कम शब्दों में दी गई जानकारी, पूरी जानकारी, और स्क्रीनशॉट को अपडेट करें.

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

   ध्यान दें: इस तरीके से अपने ऐड-ऑन को Google Workspace ऐड-ऑन में अपग्रेड करने पर, ऐसा एक बार होता है जिसे पहले जैसा नहीं किया जा सकता.

5. अगर आपने Google Workspace ऐड-ऑन में नए स्कोप जोड़े हैं, तो पक्का करें कि आपने उन्हें कॉन्फ़िगरेशन पेज पर मौजूद OAuth 2.0 स्कोप सेक्शन में जोड़ा हो. उस सेक्शन में दिए गए स्कोप, आपके ऐड-ऑन के मेनिफ़ेस्ट में बताए गए स्कोप से पूरी तरह मेल खाने चाहिए.

6. पुष्टि करें कि आपने फ़ॉर्म में सही जानकारी दी है. इसके बाद, बदलाव सेव करें पर क्लिक करें.

अगर Google Workspace ऐड-ऑन को अपग्रेड करने के दौरान कोई समस्या आती है या कोई सवाल पूछना है, तो हमसे संपर्क करें.

अक्सर पूछे जाने वाले सवाल

यहां, ऐड-ऑन अपग्रेड के बारे में अक्सर पूछे जाने वाले सवाल दिए गए हैं:

क्या एडिटर ऐड-ऑन को अपग्रेड किया जा सकता है?

एडिटर के ज़्यादातर ऐड-ऑन, Google Workspace ऐड-ऑन में ले जाए जा सकते हैं. हालांकि, उन्हें Google Workspace ऐड-ऑन पर, Gmail और Calendar के ऐड-ऑन के मुकाबले आसानी से अपग्रेड नहीं किया जा सकता.

अगर आपको Editor ऐड-ऑन को Google Workspace ऐड-ऑन पर माइग्रेट करना है, तो आपको ऐड-ऑन के यूज़र इंटरफ़ेस (यूआई) को एचटीएमएल से कार्ड-आधारित इंटरफ़ेस में फिर से लिखना होगा. साथ ही, JavaScript हैंडलिंग को कार्ड सेवा में अपडेट करना होगा.

हो सकता है कि आपके मौजूदा एडिटर ऐड-ऑन में कुछ सेवाएं कार्ड सेवा में उपलब्ध न हों. उदाहरण के लिए, अगर आपके Editor ऐड-ऑन में फ़ाइल पिकर मौजूद है, तो Card Service की मदद से Google Workspace ऐड-ऑन के लिए यह सुविधा उपलब्ध नहीं है.

क्या मुझे अलग से Google Workspace ऐड-ऑन बनाने और अपने मौजूदा ऐड-ऑन का इस्तेमाल बनाए रखने की अनुमति है?

आपके पास अलग-अलग ब्रैंड के नाम से और Google Workspace ऐड-ऑन बनाने का विकल्प है. हालांकि, हम एक ही ब्रैंड के नाम वाले Gmail या Calendar कॉन्फ़्रेंसिंग ऐड-ऑन की अनुमति नहीं देते. अगर आपका कोई सवाल है या आपको अपवाद के लिए अनुरोध करना है, तो हमसे संपर्क करें.

क्या ऐड-ऑन के अपग्रेड होने के बाद, मेरे उपयोगकर्ताओं को उसे फिर से अनुमति देनी होगी?

जब तक आपका Google Workspace ऐड-ऑन, उससे जुड़े OAuth क्लाइंट आईडी के साथ उसी बुनियादी Cloud Platform (GCP) प्रोजेक्ट का इस्तेमाल करता है, तब तक आपके उपयोगकर्ताओं को मूल ऐड-ऑन के लिए पहले से अनुमति मिली हुई अनुमतियों को फिर से अनुमति नहीं देनी होगी. हालांकि, अगर अपग्रेड की प्रोसेस के दौरान नए दायरे जोड़े जाते हैं, तो आपके उपयोगकर्ताओं को पहली बार आपके ऐड-ऑन के Google Workspace वर्शन का इस्तेमाल करते समय, उन नए दायरों की अनुमति देनी होगी.

क्या अपने Chrome एक्सटेंशन को Google Workspace ऐड-ऑन में अपग्रेड करके, उपयोगकर्ताओं को ट्रांसफ़र किया जा सकता है?

नहीं. Chrome एक्सटेंशन के उपयोगकर्ताओं, इंस्टॉल, और लिस्टिंग की समीक्षाओं को ट्रांसफ़र नहीं किया जा सकता. आपको नया Google Workspace ऐड-ऑन बनाना होगा. साथ ही, उपयोगकर्ताओं को अपने Chrome एक्सटेंशन को Google Workspace Marketplace पर भेजना होगा.

क्या Google Workspace ऐड-ऑन के साथ एक से ज़्यादा ऐड-ऑन जोड़े जा सकते हैं?

ऐप्लिकेशन इंटिग्रेशन की एक साथ सूची बनाना देखें.