Présentation de la résolution des problèmes
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page vous aide à afficher, déboguer et corriger les erreurs liées aux applications Chat, aux fiches et aux boîtes de dialogue.
Affichage des erreurs
Lorsqu'une application Google Chat renvoie une erreur, elle se manifeste comme suit :
- Un message tel que "L'application ne répond pas", Le message "Une erreur s'est produite" ou "Impossible de traiter votre demande" s'affiche.
- L'application ne fonctionne pas comme prévu.
- Aucun message ne s'affiche et l'application ne répond pas.
Lorsqu'une fiche renvoie une erreur, elle se présente comme suit :
- Une partie d'une fiche, comme un widget ou un composant, ne s'affiche pas ou s'affiche de manière inattendue.
- La fiche ne s'affiche pas en entier.
- Une boîte de dialogue se ferme, ne s'ouvre pas ou ne se charge pas.
Bien qu'aucun message d'erreur ne s'affiche dans l'UI Chat, des messages d'erreur descriptifs et des données de journaux sont disponibles pour vous aider à corriger les erreurs lorsque la journalisation des erreurs pour les applications Chat est activée.
Déboguer et résoudre les problèmes liés à Google Chat
- Activez la journalisation des erreurs pour que votre application Google Chat enregistre les erreurs lorsqu'elles se produisent.
- Consultez les journaux d'erreurs pour Google Chat afin de lire les journaux d'erreurs, de voir à quelle fréquence les erreurs se produisent et de lire les messages d'erreur descriptifs et les données de journaux qui vous aident à corriger les erreurs.
- Découvrez comment corriger les erreurs courantes :
- Déboguez votre application Chat pour l'exécuter étape par étape.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/04 (UTC).
[null,null,["Dernière mise à jour le 2025/08/04 (UTC)."],[[["\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."]]
