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

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

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

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

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

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

1. Google Cloud console में, मेन्यू > ज़्यादा प्रॉडक्ट > 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 सदस्यता न बना पाए. इसके अलावा, उपयोगकर्ता की पुष्टि करके मैसेज भेजने पर, हो सकता है कि पुष्टि किए गए उस उपयोगकर्ता को स्पेस से हटा दिया जाए जिसकी Chat के इतिहास की सेटिंग में अंतर है.

ज़्यादा जानने के लिए, 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 ऐप्लिकेशन के साथ इंटरैक्ट करने की कोशिश करते समय यह गड़बड़ी का मैसेज मिलता है, तो हो सकता है कि संगठन ने पैरंट संगठनात्मक इकाई के लिए इसे चालू किए बिना, किसी सब-संगठनात्मक इकाई को ऐक्सेस दिया हो.

इस समस्या को हल करने के तरीके के बारे में जानने के लिए, उपयोगकर्ताओं को 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 फ़ंक्शन के लॉग देखना

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

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

   Cloud Functions पर जाएं

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

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

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

Cloud Function की गड़बड़ियां देखना

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

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

   Cloud Functions पर जाएं

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

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

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

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

Cloud Functions की मदद से Chat ऐप्लिकेशन बनाते समय, कभी-कभी ये गड़बड़ियां दिख सकती हैं.

प्रोजेक्ट PROJECT_NAME में, क्षेत्र REGION_NAME में ChatApp फ़ंक्शन पहले से मौजूद है

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

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

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 फ़ंक्शन को कॉल करने की अनुमति नहीं है. "allUsers" को "Cloud Functions Invoker" भूमिका देने का मतलब है कि ऐप्लिकेशन को चलाने वाला Cloud Function सार्वजनिक तौर पर उपलब्ध है और उसे पुष्टि किए बिना ऐक्सेस किया जा सकता है. भूमिका असाइन करने का तरीका जानने के लिए, सिर्फ़ एक भूमिका असाइन करना लेख पढ़ें.

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

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