Google Chat ऐप्लिकेशन की गड़बड़ियों को हल करना और उन्हें ठीक करना

इस सेक्शन में, Chat ऐप्लिकेशन बनाने और उनकी जांच करते समय आने वाली सामान्य समस्याओं के बारे में बताया गया है.

कार्ड मैसेज, डायलॉग या लिंक की झलक, उम्मीद के मुताबिक रेंडर नहीं हो रही है या काम नहीं कर रही है

कार्ड से जुड़ी समस्याओं को हल करने में मदद पाने के लिए, कार्ड से जुड़ी समस्याओं को हल करना और उन्हें ठीक करना देखें.

ऐप्लिकेशन काम नहीं कर रहा है

अगर Chat ऐप्लिकेशन को मैसेज करने पर, आपको "ऐप्लिकेशन काम नहीं कर रहा है" मैसेज मिलता है, तो Chat ऐप्लिकेशन के कॉन्फ़िगरेशन की पुष्टि करें:

1. Google Cloud console में, मेन्यू menu > ज़्यादा प्रॉडक्ट > Google Workspace > प्रॉडक्ट लाइब्रेरी > Google Chat API > मैनेज करें > कॉन्फ़िगरेशन पर क्लिक करें.

   Chat API पर जाएं

2. ऐप्लिकेशन का स्टेटस में जाकर, पक्का करें कि आपने लाइव - उपयोगकर्ताओं के लिए उपलब्ध चुना हो.

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

   1. अगर आपका ऐप्लिकेशन मैसेज के जवाब देता है, तो 1:1 मैसेज पाएं को चुनना न भूलें.
   2. कनेक्शन सेटिंग में जाकर, पक्का करें कि एचटीटीपी एंडपॉइंट यूआरएल, Apps Script प्रोजेक्ट का डिप्लॉयमेंट आईडी, Cloud Pub/Sub का विषय का नाम या Dialogflow एजेंट सही तरीके से सेट हो और उसे डिप्लॉय किया गया हो.
   3. किसको दिखे सेक्शन में जाकर, पक्का करें कि सही उपयोगकर्ताओं के पास, ईमेल पते या Google Workspace डोमेन के किसी ग्रुप वाले ऐप्लिकेशन का ऐक्सेस हो. अगर ऐप्लिकेशन को Google Workspace Marketplace SDK टूल के साथ डिप्लॉय किया गया है, तो दिखने की सेटिंग ज़रूरी नहीं हैं. इसकी वजह यह है कि Google Workspace Marketplace की सेटिंग को प्राथमिकता दी जाती है.

4. अगर ऐप्लिकेशन को Google Workspace Marketplace के SDK टूल के साथ पब्लिश किया गया है, तो Google Workspace Marketplace की सेटिंग देखें.

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

6. ऐप्लिकेशन को फिर से मैसेज भेजने की कोशिश करें.

Google Chat API सिर्फ़ Google Workspace के उपयोगकर्ताओं के लिए उपलब्ध है

Chat ऐप्लिकेशन को कॉन्फ़िगर करते समय, आपको गड़बड़ी का मैसेज Google Chat API is only available to Google Workspace users दिख सकता है. इस मैसेज का मतलब है कि Chat API को कॉन्फ़िगर करने के लिए, आपने जिस Google खाते का इस्तेमाल किया है वह Google Workspace का इस्तेमाल करने वाले किसी संगठन का हिस्सा नहीं है. Chat ऐप्लिकेशन बनाने या Chat API का इस्तेमाल करने के लिए, आपको Google Workspace खाते का इस्तेमाल करना होगा.

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

उपयोगकर्ताओं को स्पेस से बाहर रखा जा सकता है

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

उदाहरण के लिए, अगर किसी उपयोगकर्ता के लिए चैट इतिहास की सेटिंग "चालू" है और किसी स्पेस के लिए चैट इतिहास की सेटिंग "बंद" है, तो हो सकता है कि वह उपयोगकर्ता उस स्पेस में शामिल न हो पाए. साथ ही, अगर वह उपयोगकर्ता संघर्ष से पहले स्पेस में शामिल हुआ था और वह विवाद के बाद स्पेस में कोई मैसेज पोस्ट करता है, तो उसे स्पेस से हटाया जा सकता है.

इस स्थिति में और अन्य मामलों में, जब इतिहास की सेटिंग में अंतर होता है, तो हो सकता है कि Chat API की सदस्यता न ले पाए. यह भी हो सकता है कि उपयोगकर्ता की पुष्टि करने वाला मैसेज बनाने पर, उस स्पेस से उस उपयोगकर्ता को हटाया जा सके जिसकी पुष्टि हो चुकी है और चैट के इतिहास की सेटिंग मेल नहीं खाती.

ज़्यादा जानने के लिए, Google Workspace एडमिन सहायता केंद्र पर जाएं और उपयोगकर्ताओं को स्पेस से बाहर रखा जा सकता है लेख पढ़ें.

Google Apps Script में, Chat की बेहतर सेवा से जुड़ी समस्या हल करना

ऐडवांस Chat सेवा के बारे में जानकारी देने वाला Apps Script पेज देखें.

उपयोगकर्ता, स्पेस में चैट ऐप्लिकेशन नहीं जोड़ पा रहे हैं

अगर उपयोगकर्ताओं को किसी स्पेस में Chat ऐप्लिकेशन जोड़ते समय, गड़बड़ी का मैसेज This organization's administrator must allow users to install this Chat app दिखता है, तो इस गड़बड़ी की ये वजहें हो सकती हैं:

• संगठन ने Chat ऐप्लिकेशन बंद कर दिए हैं.
• संगठन ने इस खास Chat ऐप्लिकेशन को, अनुमति वाले संगठन की अनुमति वाली सूची में नहीं जोड़ा है.

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

इस समस्या को हल करने के बारे में जानकारी के लिए, उपयोगकर्ताओं को चैट ऐप्लिकेशन इंस्टॉल करने दें देखें.

इस कार्रवाई के लिए, एडमिन को ऐप्लिकेशन को ज़रूरी OAuth की अनुमति वाले दायरे की अनुमति देनी होगी

Chat ऐप्लिकेशन के तौर पर पुष्टि करते समय, आपको गड़बड़ी का यह मैसेज दिख सकता है:

<HttpError 403 when requesting https://chat.googleapis.com/v1/spaces/{space}?alt=json returned "The administrator must grant the app the required OAuth authorization scope for this action.". Details: "The administrator must grant the app the required OAuth authorization scope for this action.">

गड़बड़ी के इस मैसेज का मतलब है कि Google Workspace के एडमिन ने अब तक, Chat ऐप्लिकेशन को एक बार की अनुमति नहीं दी है. इस अनुमति से, https://www.googleapis.com/auth/chat.app.* नाम से शुरू होने वाले अनुमति के दायरों का इस्तेमाल किया जा सकता है.

गड़बड़ी ठीक करने के लिए:

• Google Workspace एडमिन से, अपने Chat ऐप्लिकेशन को अनुमति देने के लिए कहें. Chat ऐप्लिकेशन के लॉजिक में इस गड़बड़ी को ठीक करते समय, मैसेज भेजकर यह बताएं कि अनुरोध की गई कार्रवाई करने के लिए, Chat ऐप्लिकेशन को एडमिन की अनुमति चाहिए. जैसे: To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>.
• अगर Chat API का तरीका, https://www.googleapis.com/auth/chat.bot अनुमति वाले स्कोप के साथ काम करता है, जिसके लिए एडमिन की अनुमति की ज़रूरत नहीं होती, तो इसका इस्तेमाल करें. यह देखने के लिए कि किसी तरीके को अनुमति देने का कौनसा तरीका काम करता है, Google Chat ऐप्लिकेशन और Google Chat API के अनुरोधों की पुष्टि करना और उन्हें अनुमति देना देखें.

Cloud Function से जुड़ी गड़बड़ियों को हल करना

अगर Chat ऐप्लिकेशन को Cloud Functions के साथ लागू किया गया है और यह काम नहीं कर रहा है, तो समस्या को हल करने के लिए, नीचे दिए गए सेक्शन में बताए गए हैं.

Cloud Function लॉग देखें

सबसे पहले, गड़बड़ियों का पता लगाने के लिए Cloud Functions के लॉग देखें.

1. Google Cloud Console में, Cloud Functions पेज पर जाएं:

   Cloud Functions पर जाएं

2. लॉग खोलने के लिए, Chat ऐप्लिकेशन का Cloud Function ढूंढें. इसके बाद, कार्रवाइयां दिखाएं more_vert > लॉग देखें पर क्लिक करें.

लॉग एक्सप्लोरर, Cloud Function के लॉग दिखाने वाली क्वेरी खोलता है और उसे चलाता है. इसमें गड़बड़ियां भी शामिल होती हैं.

अगर लॉग की गई डिफ़ॉल्ट जानकारी आपके ऐप्लिकेशन को डीबग करने के लिए काफ़ी नहीं है, तो आप अपने Cloud Function कोड से अतिरिक्त लॉगिंग जोड़ सकते हैं. Cloud Function के लॉग देखना और उनमें बदलाव करना लेख पढ़ें.

Cloud फ़ंक्शन से जुड़ी गड़बड़ियां देखना

लॉग के अलावा, Cloud Function भी चालू होने के दौरान मिलने वाली गड़बड़ियों की रिपोर्ट भी दे सकता है.

1. Google Cloud Console में, Cloud Functions पेज पर जाएं:

   Cloud Functions पर जाएं

2. अपने Chat ऐप्लिकेशन के Cloud Function पर क्लिक करें.

3. फ़ंक्शन की जानकारी वाले पेज पर, गड़बड़ियां गड़बड़ियां में दिखती हैं.

4. किसी गड़बड़ी को हल करने के लिए, उस पर क्लिक करें.

Cloud Function की सामान्य गड़बड़ियां ठीक करना

Cloud Functions वाला चैट ऐप्लिकेशन बनाते समय कभी-कभी ये गड़बड़ियां होती हैं.

PROJECT_NAME प्रोजेक्ट में REGION_NAME इलाके में ChatApp पहले से मौजूद है

क्लाउड फ़ंक्शन डिप्लॉय करते समय, आपको गड़बड़ी का मैसेज Function ChatApp in region REGION_NAME in project PROJECT_NAME already exists मिल सकता है. इस मैसेज का मतलब है कि किसी दूसरे Cloud फ़ंक्शन का नाम, डिप्लॉय किए जा रहे फ़ंक्शन के नाम जैसा है. नाम बदलें और फ़ंक्शन को फिर से डिप्लॉय करें. पुष्टि करें कि Chat ऐप्लिकेशन आपके Cloud फ़ंक्शन के लिए ट्रिगर यूआरएल का इस्तेमाल करता है, न कि पहले से मौजूद Cloud फ़ंक्शन के ट्रिगर यूआरएल का.

नीति में बताए गए एक या उससे ज़्यादा उपयोगकर्ता, अनुमति वाले ग्राहक से नहीं जुड़े हैं

Cloud Function को डिप्लॉय करते समय, आपको गड़बड़ी का यह मैसेज दिख सकता है The operation cannot be completed on the function: "One or more users named in the policy do not belong to a permitted customer." अगर आपको यह गड़बड़ी दिखती है और फिर Chat ऐप्लिकेशन को मैसेज भेजा जाता है, तो आपको गड़बड़ी का यह मैसेज दिखता है कि ऐप्लिकेशन काम नहीं कर रहा है. इसकी वजह यह है कि Google Chat, Cloud Function को होस्ट करने वाले सर्वर तक नहीं पहुंच पा रहा है. इस मैसेज का मतलब है कि "allUsers" नाम के उपयोगकर्ता के पास Cloud Function को कॉल करने की अनुमति नहीं है. "allUsers" को "Cloud Functions Invoker" भूमिका देने का मतलब है कि ऐप्लिकेशन को चलाने वाला Cloud Function सार्वजनिक तौर पर उपलब्ध है और उसे पुष्टि किए बिना ऐक्सेस किया जा सकता है. भूमिका असाइन करने का तरीका जानने के लिए, एक भूमिका देना लेख पढ़ें.

इस गड़बड़ी का मतलब यह हो सकता है कि Google Cloud प्रोजेक्ट पर डोमेन से जुड़ी पाबंदी लगी हो. डोमेन पर पाबंदी से जुड़ी सीमाओं के बारे में ज़्यादा जानने के लिए, डोमेन के आधार पर पहचानों पर पाबंदी लगाना लेख पढ़ें.

इस समस्या को हल करने के लिए, पुष्टि करें कि आपका Cloud फ़ंक्शन, पुष्टि न किए गए इनवॉइस की अनुमति देता है. किसी मौजूदा Cloud फ़ंक्शन के लिए, पुष्टि नहीं किए गए उसे शुरू करने की अनुमति देने का तरीका जानने के लिए, सार्वजनिक (बिना पुष्टि वाले) ऐक्सेस की अनुमति देना देखें.