Google Chat ऐप्लिकेशन माइग्रेट करना

Google Workspace के संगठनों को मर्ज करने पर, आपको Chat ऐप्लिकेशन माइग्रेट करना पड़ सकता है, ताकि वह काम करता रहे.

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

अगर आपको Chat ऐप्लिकेशन माइग्रेट करना है, तो तीन चरणों वाली यह प्रोसेस पूरी करें:

1. मर्ज किए गए संगठन में Google Cloud प्रोजेक्ट बनाकर, एपीआई चालू करके, और OAuth 2.0 के लिए सहमति वाली स्क्रीन को कॉन्फ़िगर करके, Chat ऐप्लिकेशन के लिए एनवायरमेंट सेट अप करें. हालांकि, OAuth 2.0 के लिए सहमति वाली स्क्रीन को कॉन्फ़िगर करना ज़रूरी नहीं है.
2. नए Cloud प्रोजेक्ट से, Chat ऐप्लिकेशन को फिर से डिप्लॉय करें.
3. फिर से बनाए गए Chat ऐप्लिकेशन को Chat स्पेस या बातचीत में जोड़ें. इसके बाद, ओरिजनल Chat ऐप्लिकेशन को बंद करें.

मर्ज किए गए संगठन में Cloud प्रोजेक्ट बनाना और एपीआई चालू करना

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

Cloud प्रोजेक्ट बनाना

Google Cloud कंसोल

1. Google Cloud Console में, मेन्यू > IAM और एडमिन > प्रोजेक्ट बनाएं पर जाएं.

   प्रोजेक्ट बनाएं पर जाएं

2. प्रोजेक्ट का नाम फ़ील्ड में, अपने प्रोजेक्ट के लिए जानकारी देने वाला नाम डालें.

   ज़रूरी नहीं: प्रोजेक्ट आईडी में बदलाव करने के लिए, बदलाव करें पर क्लिक करें. प्रोजेक्ट बनाने के बाद, प्रोजेक्ट आईडी बदला नहीं जा सकता. इसलिए, ऐसा आईडी चुनें जो प्रोजेक्ट के जीवनकाल के दौरान आपकी ज़रूरतों के हिसाब से हो.

3. जगह फ़ील्ड में, अपने प्रोजेक्ट के लिए संभावित जगहें देखने के लिए, ब्राउज़ करें पर क्लिक करें. इसके बाद, चुनें पर क्लिक करें.
   चेतावनी: क्या आपको अपना Google Workspace संगठन नहीं मिल रहा है?
   इसका मतलब है कि आपने Google Workspace खाते से साइन इन नहीं किया है. Google Workspace के डेवलपर दस्तावेज़ में बताई गई कुछ सुविधाएं, सिर्फ़ किसी संगठन से जुड़े प्रोजेक्ट के लिए उपलब्ध हैं.
4. बनाएं पर क्लिक करें. Google Cloud Console, डैशबोर्ड पेज पर नेविगेट करता है. आपका प्रोजेक्ट कुछ ही मिनटों में बन जाता है.

gcloud सीएलआई

डेवलपमेंट के इन एनवायरमेंट में से किसी एक में, Google Cloud सीएलआई (gcloud) ऐक्सेस करें:

• Cloud Shell: gcloud सीएलआई के साथ ऑनलाइन टर्मिनल का इस्तेमाल करने के लिए, Cloud Shell को चालू करें. इसमें gcloud सीएलआई पहले से सेट अप होता है.
  Cloud Shell चालू करें
• लोकल शेल: लोकल डेवलपमेंट एनवायरमेंट का इस्तेमाल करने के लिए, gcloud सीएलआई इंस्टॉल करें और उसे शुरू करें.
  Cloud प्रोजेक्ट बनाने के लिए, gcloud projects create निर्देश का इस्तेमाल करें:

  gcloud projects create PROJECT_ID

  PROJECT_ID की जगह, वह आईडी डालें जिसे आपको प्रोजेक्ट के लिए सेट करना है.

एपीआई चालू करें

सभी Chat ऐप्लिकेशन के लिए, Google Chat API चालू करना ज़रूरी है. Chat ऐप्लिकेशन को बनाने के तरीके के आधार पर, आपको अन्य एपीआई चालू करने पड़ सकते हैं. उदाहरण के लिए, अगर आपने Google Cloud Functions का इस्तेमाल करके Chat ऐप्लिकेशन बनाया है, तो Cloud Build API, Cloud Functions API, Pub/Sub API, Cloud Logging API, Artifact Registry API, और Cloud Run API चालू करें. सबसे सही तरीका यह है कि माइग्रेट किए गए ऐप्लिकेशन को काम करने के लिए, नए क्लाउड प्रोजेक्ट में वही एपीआई चालू करें जो पुराने क्लाउड प्रोजेक्ट में चालू हैं.

किसी एपीआई को चालू करने के लिए, यह तरीका अपनाएं:

Google Cloud कंसोल

1. Google Cloud Console में, मेन्यू > एपीआई और सेवाएं > लाइब्रेरी > Google Workspace पर जाएं.

   एपीआई लाइब्रेरी पर जाएं

2. उस एपीआई पर क्लिक करें जिसे आपको चालू करना है.
3. चालू करें पर क्लिक करें.
4. ज़्यादा एपीआई चालू करने के लिए, यह तरीका दोहराएं.

Google Cloud सीएलआई

1. Google Cloud Command Line Interface (सीएलआई) इंस्टॉल करें या खोलें.

2. services enable निर्देश चलाएं. इसमें यह बताएं कि आपको कौनसी एपीआई सेवा चालू करनी है.

   gcloud services enable API_SERVICE_ID

Chat API कॉन्फ़िगर करना

अपने नए क्लाउड प्रोजेक्ट में, आपको Chat ऐप्लिकेशन का नाम, ब्यौरा, और आइकॉन बताने के लिए, Chat API का इस्तेमाल करना होगा. इनकी जानकारी कॉन्फ़िगर करने के लिए, देखें Chat API कॉन्फ़िगर करना

उस स्क्रीन को कॉन्फ़िगर करें जहां OAuth को सहमति दी जाती है

हो सकता है कि आपको अपने Cloud प्रोजेक्ट के लिए, उस स्क्रीन को कॉन्फ़िगर करना पड़े जहां OAuth को सहमति दी जाती है. अगर आपने पहले ऑथराइज़ेशन के लिए OAuth 2.0 का इस्तेमाल किया है, तो ऐक्सेस के लिए उसी ऑथराइज़ेशन स्कोप का इस्तेमाल करें.

1. Google API Console में, मेन्यू > Google Auth प्लैटफ़ॉर्म > ब्रैंडिंग पर जाएं.

   ब्रैंडिंग पर जाएं

2. अगर आपने Google Auth प्लैटफ़ॉर्म को पहले ही कॉन्फ़िगर कर लिया है, तो ब्रैंडिंग, ऑडियंस, और डेटा ऐक्सेस में, OAuth के लिए सहमति वाली स्क्रीन की इन सेटिंग को कॉन्फ़िगर किया जा सकता है. अगर आपको Google Auth प्लैटफ़ॉर्म को अब तक कॉन्फ़िगर नहीं किया गया है मैसेज दिखता है, तो शुरू करें पर क्लिक करें:
1. ऐप्लिकेशन की जानकारी में, ऐप्लिकेशन का नाम में जाकर, ऐप्लिकेशन का नाम डालें.
2. उपयोगकर्ता सहायता के लिए ईमेल में, सहायता के लिए कोई ईमेल पता चुनें. अगर उपयोगकर्ताओं के पास सहमति से जुड़े सवाल हैं, तो वे इस ईमेल पते पर आपसे संपर्क कर सकते हैं.
3. आगे बढ़ें पर क्लिक करें.
4. ऑडियंस में जाकर, अपने ऐप्लिकेशन के लिए उपयोगकर्ता का टाइप चुनें.
5. आगे बढ़ें पर क्लिक करें.
6. संपर्क जानकारी में, ईमेल पता डालें. इस ईमेल पते पर आपको अपने प्रोजेक्ट में किए गए किसी भी बदलाव के बारे में सूचना मिल सकती है.
7. आगे बढ़ें पर क्लिक करें.
8. पूरा करें में जाकर, Google API सेवाओं के उपयोगकर्ता के डेटा से जुड़ी नीति की समीक्षा करें. अगर आपको यह नीति स्वीकार है, तो मैं Google API सेवाओं के उपयोगकर्ता के डेटा से जुड़ी नीति से सहमत हूं को चुनें.
9. जारी रखें पर क्लिक करें.
10. बनाएं पर क्लिक करें.
11. अगर आपने उपयोगकर्ता के टाइप के लिए बाहरी को चुना है, तो टेस्ट करने वाले उपयोगकर्ता जोड़ें:
    1. ऑडियंस पर क्लिक करें.
    2. टेस्ट करने वाले उपयोगकर्ता में जाकर, उपयोगकर्ता जोड़ें पर क्लिक करें.
    3. अपना ईमेल पता और टेस्ट करने के लिए अनुमति वाले अन्य उपयोगकर्ताओं के ईमेल पते डालें. इसके बाद, सेव करें पर क्लिक करें.

3. अगर आपके Google Workspace संगठन के बाहर इस्तेमाल करने के लिए कोई ऐप्लिकेशन बनाया जा रहा है, तो डेटा ऐक्सेस > स्कोप जोड़ें या हटाएं पर क्लिक करें. हमारा सुझाव है कि स्कोप चुनते समय, ये सबसे सही तरीके अपनाएं:

   • ऐसे स्कोप चुनें जो आपके ऐप्लिकेशन के लिए ज़रूरी, कम से कम लेवल का ऐक्सेस देते हों. उपलब्ध स्कोप की सूची देखने के लिए, Google APIs के लिए OAuth 2.0 स्कोप लेख पढ़ें.
   • तीनों सेक्शन में मौजूद स्कोप की समीक्षा करें: संवेदनशील न होने वाले स्कोप, संवेदनशील स्कोप, और पाबंदी वाले स्कोप. "संवेदनशील स्कोप" या "पाबंदी वाले स्कोप" सेक्शन में मौजूद किसी भी स्कोप के लिए, संवेदनशील न होने वाले वैकल्पिक स्कोप ढूंढने की कोशिश करें, ताकि अतिरिक्त समीक्षाओं से बचा जा सके.
   • कुछ स्कोप के लिए, Google से अतिरिक्त समीक्षाएं ज़रूरी होती हैं. सिर्फ़ आपके Google Workspace संगठन में इस्तेमाल किए जाने वाले ऐप्लिकेशन के लिए, सहमति वाली स्क्रीन पर स्कोप की सूची नहीं दिखती. साथ ही, पाबंदी वाले या संवेदनशील स्कोप के इस्तेमाल के लिए, Google से आगे की समीक्षा की ज़रूरत नहीं होती. ज़्यादा जानकारी के लिए, स्कोप की कैटगरी लेख पढ़ें.
4. अपने ऐप्लिकेशन के लिए ज़रूरी स्कोप चुनने के बाद, सेव करें पर क्लिक करें.

OAuth के लिए सहमति वाली स्क्रीन को कॉन्फ़िगर करने के बारे में ज़्यादा जानकारी के लिए, Google Auth प्लैटफ़ॉर्म का इस्तेमाल शुरू करना लेख पढ़ें.

Chat ऐप्लिकेशन को नए Cloud प्रोजेक्ट में फिर से डिप्लॉय करना

Chat ऐप्लिकेशन को Apps Script, AppSheet या Python या Java जैसे किसी अन्य कनेक्शन टाइप से बनाया गया है या नहीं, इसके आधार पर, Chat ऐप्लिकेशन को फिर से डिप्लॉय करने का तरीका थोड़ा अलग होता है. दोनों ही मामलों में, आपको अपना पूरा कोड फिर से बनाने की ज़रूरत नहीं होती. हालांकि, आपको कुछ बदलाव करने पड़ते हैं.

Chat ऐप्लिकेशन की लॉजिक माइग्रेट करना

Chat ऐप्लिकेशन के आर्किटेक्चर के आधार पर, आपको अन्य सेवाओं को नए Cloud प्रोजेक्ट में माइग्रेट करना पड़ सकता है:

• एचटीटीपी ऐप्लिकेशन के लिए, आपको ऐप्लिकेशन की बाकी लॉजिक भी माइग्रेट करनी होगी. इसे Cloud Run फ़ंक्शन, Cloud Run या App Engine का इस्तेमाल करके बनाया गया था.
• बातचीत वाले Chat ऐप्लिकेशन के लिए, आपको Dialogflow एजेंट भी माइग्रेट करने होंगे. ये ऐप्लिकेशन, नैचुरल लैंग्वेज का इस्तेमाल करते हैं.
• फ़ायरवॉल के पीछे बने Chat ऐप्लिकेशन के लिए, आपको Pub/Sub विषयों को भी माइग्रेट करना होगा.

नए क्लाउड प्रोजेक्ट में इंटरैक्टिव सुविधाएं कॉन्फ़िगर करना

Python या Java जैसी किसी भाषा से बने Chat ऐप्लिकेशन को फिर से डिप्लॉय करने के लिए, अपने नए Cloud प्रोजेक्ट में Chat ऐप्लिकेशन को कॉन्फ़िगर करें.

इंटरैक्टिव सुविधाएं कॉन्फ़िगर करने के लिए, उपयोगकर्ता के इंटरैक्शन पाना और उनका जवाब देना लेख पढ़ें.

Apps Script से बने Chat ऐप्लिकेशन को फिर से डिप्लॉय करना

Apps Script से बने Chat ऐप्लिकेशन को फिर से डिप्लॉय करने के लिए, उस क्लाउड प्रोजेक्ट का नंबर बदलें जिससे Apps Script प्रोजेक्ट जुड़ा है. इसकी जगह, अपने नए क्लाउड प्रोजेक्ट का प्रोजेक्ट नंबर डालें. इसके बाद, Apps Script के डिप्लॉयमेंट आईडी को कॉपी करें और उसे Google API Console में, Chat ऐप्लिकेशन के कॉन्फ़िगरेशन पेज पर चिपकाएं.

अपने Cloud प्रोजेक्ट का नंबर कॉपी करना

1. Google API Console में, मेन्यू > IAM और एडमिन > सेटिंग पर जाएं.

   IAM और एडमिन सेटिंग पर जाएं

2. प्रोजेक्ट नंबर फ़ील्ड में, वैल्यू कॉपी करें.

अपने Apps Script प्रोजेक्ट में, Google Cloud प्रोजेक्ट का नंबर सेट करना

1. Apps Script पर जाएं.

   Apps Script पर जाएं

2. Chat ऐप्लिकेशन के Apps Script प्रोजेक्ट में, प्रोजेक्ट सेटिंग पर क्लिक करें.

3. Google Cloud Platform (GCP) प्रोजेक्ट में जाकर, प्रोजेक्ट बदलें पर क्लिक करें.

4. GCP प्रोजेक्ट नंबर में, Google Cloud प्रोजेक्ट का नंबर चिपकाएं.

5. प्रोजेक्ट सेट करें पर क्लिक करें.

अपने Apps Script प्रोजेक्ट का डिप्लॉयमेंट आईडी कॉपी करना

1. Apps Script में सबसे ऊपर दाईं ओर, डिप्लॉय करें > डिप्लॉयमेंट मैनेज करें पर क्लिक करें.
2. डिप्लॉयमेंट आईडी में जाकर, कॉपी करें पर क्लिक करें.
3. हो गया पर क्लिक करें.

Chat ऐप्लिकेशन को फिर से कॉन्फ़िगर करना और डिप्लॉय करना

1. Google API Console में, "Google Chat API" खोजें और Google Chat API पर क्लिक करें. इसके बाद, मैनेज करें पर क्लिक करें.

   Chat API पर जाएं

2. कॉन्फ़िगरेशन टैब पर क्लिक करें और ज़रूरी जानकारी डालें:

   • ऐप्लिकेशन का नाम: वह नाम जिसका इस्तेमाल लोग, आपके Chat ऐप्लिकेशन से इंटरैक्ट करते समय करते हैं.
   • अवतार का यूआरएल: एक एचटीटीपीएस यूआरएल, जो कम से कम 128x128 पिक्सल वाली स्क्वेयर ग्राफ़िक्स इमेज (उदाहरण के लिए, PNG या JPEG) की ओर ले जाता है. यह इमेज, आपके Chat ऐप्लिकेशन के अवतार के तौर पर दिखती है.
   • ब्यौरा: Chat ऐप्लिकेशन के मकसद का ब्यौरा, जो आपके Chat ऐप्लिकेशन के नाम के नीचे दिखता है.

3. इंटरैक्टिव सुविधाएं चालू करने के लिए, इंटरैक्टिव सुविधाएं चालू करें टॉगल पर क्लिक करें. इससे उपयोगकर्ता, आपके Chat ऐप्लिकेशन से इंटरैक्ट कर सकते हैं:

4. कनेक्शन सेटिंग में जाकर, Apps Script प्रोजेक्ट चुनें.

5. डिप्लॉयमेंट आईडी फ़ील्ड में, वह डिप्लॉयमेंट आईडी चिपकाएं जिसे आपने पहले कॉपी किया था.

6. बाकी कॉन्फ़िगरेशन पूरा करने के लिए, नए क्लाउड प्रोजेक्ट में Chat ऐप्लिकेशन को कॉन्फ़िगर करना लेख में मौजूद टेबल देखें

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

AppSheet से बने Chat ऐप्लिकेशन को फिर से डिप्लॉय करना

AppSheet से बने Chat ऐप्लिकेशन को अपने नए Cloud प्रोजेक्ट में फिर से डिप्लॉय करने के लिए, ऐप्लिकेशन को नए Cloud प्रोजेक्ट में कॉपी करें.

सेवा खाता अपडेट करना

अगर आपका Chat ऐप्लिकेशन, ऐप्लिकेशन के तौर पर पुष्टि करता है और Google API को कॉल करने के लिए सेवा खाते का इस्तेमाल करता है, तो Chat ऐप्लिकेशन के सेवा खाते की जानकारी अपडेट करें. ज़्यादा जानकारी के लिए, Chat ऐप्लिकेशन के तौर पर पुष्टि करना लेख पढ़ें.

Chat ऐप्लिकेशन शेयर करना

Chat ऐप्लिकेशन को नए संगठन के उपयोगकर्ताओं के लिए उपलब्ध कराने से पहले, हो सकता है कि आपके एडमिन को Chat ऐप्लिकेशन को ऐक्सेस करने की अनुमति मैन्युअल तरीके से देनी पड़े. ज़्यादा जानकारी के लिए, Google Workspace Marketplace के दस्तावेज़ में, Google Workspace के संगठनों के लिए ऐक्सेस कॉन्फ़िगर करना लेख पढ़ें.

नए Chat ऐप्लिकेशन पर स्विच करना

Chat ऐप्लिकेशन को नए संगठन में माइग्रेट कर दिया गया है. अब इसे सार्वजनिक करने का समय है. इसे Chat स्पेस या डायरेक्ट मैसेज में जोड़ें. इसके बाद, उनमें से पुराने Chat ऐप्लिकेशन को हटाएं, ताकि लोग सिर्फ़ माइग्रेट किए गए Chat ऐप्लिकेशन को मैसेज भेज सकें.

सबसे सही तरीका: माइग्रेट किए गए Chat ऐप्लिकेशन को अपनाने में मदद करने के लिए, अपने उपयोगकर्ताओं को माइग्रेशन के बारे में बताएं. साथ ही, उन्हें Chat स्पेस और बातचीत में माइग्रेट किए गए Chat ऐप्लिकेशन को इंस्टॉल करने के लिए बढ़ावा दें.

नए Chat ऐप्लिकेशन को Chat स्पेस में जोड़ना

1. Chat पर जाएं.

   Chat पर जाएं

2. किसी डायरेक्ट मैसेज या स्पेस पर क्लिक करें.

3. स्पेस या व्यक्ति के नाम के बगल में मौजूद, ड्रॉप-डाउन पर क्लिक करें. इसके बाद, ऐप्लिकेशन और इंटिग्रेशन चुनें.

4. ऐप्लिकेशन जोड़ें पर क्लिक करें.

5. ऐप्लिकेशन का नाम डालें, सूची में से ऐप्लिकेशन चुनें, और फिर जोड़ें पर क्लिक करें.

6. हर उस स्पेस या डायरेक्ट मैसेज के लिए यह तरीका दोहराएं जिसमें आपको Chat ऐप्लिकेशन जोड़ना है.

Chat स्पेस से पुराना Chat ऐप्लिकेशन हटाना

1. Chat पर जाएं.

   Chat पर जाएं

2. किसी डायरेक्ट मैसेज या स्पेस पर क्लिक करें.

3. स्पेस या व्यक्ति के नाम के बगल में मौजूद, ड्रॉप-डाउन पर क्लिक करें. इसके बाद, ऐप्लिकेशन और इंटिग्रेशन चुनें.

4. माइग्रेट न किए गए पुराने Chat ऐप्लिकेशन के बगल में, ज़्यादा विकल्प पर क्लिक करें. इसके बाद, स्पेस से हटाएं पर क्लिक करें.

5. हर उस स्पेस या डायरेक्ट मैसेज के लिए यह तरीका दोहराएं जिससे आपको पुराना Chat ऐप्लिकेशन हटाना है.

पुराना Chat ऐप्लिकेशन बंद करना

उपयोगकर्ताओं को पुराना Chat ऐप्लिकेशन इस्तेमाल करने से रोकने और उन्हें नया Chat ऐप्लिकेशन इस्तेमाल करने के लिए बढ़ावा देने के लिए, पुराना Chat ऐप्लिकेशन बंद करें और उसे Google Workspace Marketplace से अनपब्लिश करें.