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

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

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

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

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

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

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

कोई क्लाउड प्रोजेक्ट बनाना

Google Cloud कंसोल

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

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

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

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

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

gcloud सीएलआई

नीचे दिए गए डेवलपमेंट एनवायरमेंट में से किसी एक में, Google Cloud CLI (gcloud) को ऐक्सेस करें:

• Cloud Shell: gcloud CLI के साथ ऑनलाइन टर्मिनल का इस्तेमाल करने के लिए, Cloud Shell चालू करें.
  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 चालू करें. सबसे सही तरीका यह है कि माइग्रेट किए गए ऐप्लिकेशन के काम करने के लिए, नए Cloud प्रोजेक्ट में वही एपीआई चालू करें जो पुराने Cloud प्रोजेक्ट में चालू हैं.

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

Google Cloud कंसोल

1. Google Cloud Console में, मेन्यू > ज़्यादा प्रॉडक्ट > Google Workspace > प्रॉडक्ट लाइब्रेरी पर जाएं.

   प्रॉडक्ट लाइब्रेरी पर जाएं

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

Google Cloud सीएलआई

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

2. services enable कमांड चलाएं और बताएं कि कौनसी एपीआई सेवा चालू करनी है.

   gcloud services enable API_SERVICE_ID

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

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

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

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

1. Google Cloud Console में, मेन्यू &gt &gt ब्रैंडिंग पर जाएं.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Google Cloud console में, मेन्यू &gt IAM और एडमिन &gt सेटिंग पर जाएं.

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

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 Cloud Console में, "Google Chat API" खोजें और Google Chat API पर क्लिक करें. इसके बाद, मैनेज करें पर क्लिक करें.

   Chat API पर जाएं

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

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

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

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

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

6. बाकी कॉन्फ़िगरेशन पूरा करने के लिए, नए Cloud प्रोजेक्ट में 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 से अनपब्लिश करें.