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 कंसोलgcloud सीएलआई

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

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

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

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

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

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

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

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

Google Cloud कंसोलGoogle Cloud सीएलआई

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

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

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

1. Google Cloud का कमांड-लाइन इंटरफ़ेस (सीएलआई) इंस्टॉल या खोलें.

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

   gcloud services enable API_SERVICE_ID

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

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

OAuth की सहमति वाली स्क्रीन को कॉन्फ़िगर करना

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

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

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

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 के विषयों को भी माइग्रेट करना होगा.

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

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

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

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

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

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

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

   Chat API पर जाना

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Chat पर जाएं.

   Chat पर जाएं

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

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

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

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

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

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

1. Chat पर जाएं.

   Chat पर जाएं

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

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

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

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

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

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

मिलते-जुलते विषय

• ऐप्लिकेशन पब्लिश करना