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

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

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

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

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

1. अपना मौजूदा Gmail ऐड-ऑन या 'कैलेंडर' कॉन्फ़्रेंसिंग ऐड-ऑन 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 मैसेज थ्रेड या कैलेंडर इवेंट खोलना.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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