عیب یابی نمای کلی
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این صفحه به شما کمک می کند تا برنامه های چت، کارت و خطاهای گفتگو را مشاهده، اشکال زدایی و رفع کنید.
چگونه خطاها ظاهر می شوند
وقتی یک برنامه Google Chat خطایی را برمی‌گرداند، به این صورت ظاهر می‌شود:
- پیامی مانند «برنامه پاسخ نمی‌دهد.»، «مشکلی پیش آمد.» یا «نمی‌توان درخواست شما را پردازش کرد» نمایش داده می‌شود.
- برنامه همانطور که در نظر گرفته شده کار نمی کند.
- هیچ پیامی نمایش داده نمی شود و برنامه پاسخ نمی دهد.
هنگامی که یک کارت یک خطا را برمی گرداند، به صورت زیر ظاهر می شود:
- بخشی از کارت، مانند یک ویجت یا جزء، ظاهر نمی‌شود یا به شکل غیرمنتظره‌ای رندر نمی‌شود.
- کل کارت ظاهر نمی شود.
- یک گفتگو بسته می شود، باز نمی شود، یا بارگیری نمی شود.
اگرچه ممکن است پیام خطا در رابط کاربری گپ نمایش داده نشود، پیام‌های خطای توصیفی و داده‌های گزارش در دسترس هستند تا به شما کمک کنند هنگام فعال بودن ثبت خطا برای برنامه‌های گپ، خطاها را برطرف کنید.
اشکال زدایی و عیب یابی خطاهای Google Chat
- ثبت خطا را روشن کنید تا برنامه چت Google شما خطاها را در صورت وقوع و زمانی که رخ می‌دهند، ثبت کند.
- گزارش‌های خطای Google Chat را برای خواندن گزارش‌های خطا، مشاهده تعداد دفعات وقوع خطا، خواندن پیام‌های خطای توصیفی و داده‌های گزارش که به شما در رفع خطاها کمک می‌کنند، جستجو کنید.
- آموزش رفع خطاهای رایج:
- برنامه چت خود را اشکال زدایی کنید تا مرحله به مرحله اجرا شود.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-04 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis page provides guidance on viewing, debugging, and resolving errors in Google Chat apps, cards, and dialogs.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Chat errors can manifest as error messages, unexpected app behavior, or lack of response, while card errors might result in partial or complete rendering failures.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can leverage error logging, log querying, and troubleshooting resources to identify and fix errors in their Chat apps, cards, and dialogs.\u003c/p\u003e\n"],["\u003cp\u003eSpecific guides are available to address common Chat app errors, card and dialog issues, and enable step-by-step debugging for comprehensive troubleshooting.\u003c/p\u003e\n"]]],["This content details how to manage errors in Google Chat apps, cards, and dialogs. Errors manifest as unresponsive apps, missing or malfunctioning card elements, or closed/failed dialogs. To address this, enable error logging. Query error logs to identify the frequency and nature of errors. Resources are available to fix common app, card, and dialog issues, and a debug feature allows for step-by-step execution analysis.\n"],null,["This page helps you view, debug, and fix Chat apps, card, and dialog errors.\n\nHow errors appear\n\nWhen a Google Chat app returns an error, it manifests like this:\n\n- A message like \"App is not responding.\", \"Something went wrong.\", or \"Unable to process your request\" displays.\n- The app doesn't work as intended.\n- No message displays, and the app doesn't respond.\n\nWhen a [card](/workspace/chat/create-messages#create) returns an error, it manifests like this:\n\n- Part of a card, like a widget or component, doesn't appear or renders in an unexpected way.\n- The entire card doesn't appear.\n- A dialog closes, doesn't open, or doesn't load.\n\nAlthough an error message might not display in the Chat UI, descriptive error messages and log data are available to help you fix errors when error logging for Chat apps is turned on.\n\nDebug and troubleshoot Google Chat errors\n\n1. [Turn on error logging](/workspace/chat/turn-on-error-logging) so your Google Chat app logs errors if and when they occur.\n2. [Query error logs for Google Chat](/workspace/chat/query-logs) to read error logs, see how often errors occur, and read descriptive error messages and log data that help you fix the errors.\n3. Learn how to fix common errors:\n - [Fix Google Chat app errors](/workspace/chat/troubleshoot-chat-apps) like \"App is not responding\", \"Google Chat API is only available to Google Workspace users\", or \"Users can be excluded from spaces\".\n - [Fix card and dialog errors](/workspace/chat/troubleshoot-cards) like card messages, dialogs, or link previews not rendering or working as expected.\n4. [Debug your Chat app](/workspace/chat/debug-apps) to execute it step by step."]]
