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

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

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

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

ऐप्लिकेशन जवाब नहीं दे रहा है

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

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

    Chat API पर जाएं

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

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

    1. डिफ़ॉल्ट रूप से, ऐप्लिकेशन लोगों से मिले डायरेक्ट मैसेज का जवाब दे सकते हैं.
    2. अगर आपका ऐप्लिकेशन, स्पेस और ग्रुप चैट में मैसेज का जवाब देता है, तो स्पेस और ग्रुप बातचीत में शामिल हों को चुनें.
    3. कनेक्शन सेटिंग में जाकर, पक्का करें कि एचटीटीपी एंडपॉइंट यूआरएल, Apps Script प्रोजेक्ट का डिप्लॉयमेंट आईडी, Cloud Pub/Sub का विषय का नाम या Dialogflow एजेंट सही तरीके से सेट किया गया हो और उसे डिप्लॉय किया गया हो.
    4. दिखने की सेटिंग में जाकर, पक्का करें कि सही उपयोगकर्ताओं के पास ऐप्लिकेशन का ऐक्सेस हो. इसके लिए, उन्हें ईमेल पता या 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 के इतिहास की सेटिंग "चालू" पर सेट है और किसी स्पेस के लिए Chat के इतिहास की सेटिंग "बंद" पर सेट है, तो हो सकता है कि वह उपयोगकर्ता उस स्पेस में शामिल न हो पाए. इसके अलावा, अगर उपयोगकर्ता ने विवाद से पहले स्पेस में शामिल होकर, विवाद के बाद स्पेस में कोई मैसेज पोस्ट किया है, तो उसे स्पेस से हटाया जा सकता है.

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

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

Google Apps Script में Advanced Chat सेवा से जुड़ी समस्याओं को हल करना

ऐडवांस चैट सेवा के बारे में जानने के लिए, Apps Script पेज देखें.

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

अगर उपयोगकर्ताओं को किसी स्पेस में 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 Functions से जुड़ी गड़बड़ियों को ठीक करना

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

Cloud Functions के लॉग देखना

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

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

    Cloud Functions पर जाएं

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

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

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

Cloud Functions से जुड़ी गड़बड़ियों की जांच करना

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

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

    Cloud Functions पर जाएं

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

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

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

Cloud Functions से जुड़ी सामान्य गड़बड़ियां ठीक करना

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

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

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

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

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 Function, बिना पुष्टि किए गए अनुरोधों को स्वीकार करता है. किसी मौजूदा Cloud फ़ंक्शन के लिए, बिना पुष्टि किए गए अनुरोधों को अनुमति देने का तरीका जानने के लिए, सार्वजनिक (बिना पुष्टि किए गए) ऐक्सेस की अनुमति देना लेख पढ़ें.