Gmail और Calendar के लेगसी ऐड-ऑन को अपग्रेड करें

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

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

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

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

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

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

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

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

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

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 Marketplace में लिस्ट करने से पहले, Google Workspace के सभी ऐड-ऑन को मंज़ूरी मिलनी चाहिए. भले ही, वह अपग्रेड किया गया ऐड-ऑन हो या नए सिरे से बनाया गया हो.

समीक्षा के लिए ऐड-ऑन सबमिट करने के लिए, यह तरीका अपनाएं:

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

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

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

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

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

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

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

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

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

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

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

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

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

क्या मैं Editor add-on को अपग्रेड कर सकता/सकती हूं?

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

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

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

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

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

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

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

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

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

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

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