نظرة عامة على تحديد المشاكل وحلّها
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تساعدك هذه الصفحة في عرض أخطاء تطبيقات Chat والبطاقات ومربّعات الحوار وتصحيحها وتحديد مصدرها.
كيفية ظهور الأخطاء
عندما يعرض تطبيق Google Chat خطأً، يظهر على النحو التالي:
- رسالة مثل "التطبيق لا يستجيب" يظهر الخطأ "حدث خطأ" أو "يتعذّر معالجة طلبك".
- لا يعمل التطبيق على النحو المطلوب.
- لا تظهر أي رسالة، ولا يستجيب التطبيق.
عندما تعرض بطاقة خطأً، يظهر على النحو التالي:
- لا يظهر جزء من البطاقة، مثل أداة أو مكوّن، أو يتم عرضه بطريقة غير متوقّعة.
- لا تظهر البطاقة بأكملها.
- يتم إغلاق مربّع حوار أو لا يتم فتحه أو تحميله.
على الرغم من أنّه قد لا تظهر رسالة خطأ في واجهة مستخدم Chat، تتوفّر رسائل خطأ وصفية وبيانات سجلّات لمساعدتك في إصلاح الأخطاء عند تفعيل تسجيل الأخطاء لتطبيقات Chat.
تصحيح أخطاء Google Chat وتحديد المشاكل وحلّها
- فعِّل تسجيل الأخطاء لكي يسجّل تطبيق Google Chat الأخطاء عند حدوثها.
- الاستعلام عن سجلّات الأخطاء في Google Chat لقراءة سجلّات الأخطاء والاطّلاع على عدد مرات حدوث الأخطاء وقراءة رسائل الخطأ الوصفية وبيانات السجلّ التي تساعدك في حلّ الأخطاء
- تعرَّف على كيفية حلّ الأخطاء الشائعة:
- تصحيح أخطاء تطبيق Chat لتنفيذه خطوة بخطوة
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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."]]
