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

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

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

अगर आपने 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 मैसेज थ्रेड या Calendar इवेंट खोलना.

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

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

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

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

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

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

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

क्या मेरे पास 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 ऐड-ऑन के साथ एक से ज़्यादा ऐड-ऑन बंडल किए जा सकते हैं?

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