トラブルシューティングの概要

このページでは、Chat 用アプリ、カード、ダイアログのエラーの表示、デバッグ、修正について説明します。

エラーの表示方法

Google Chat アプリがエラーを返すと、次のように表示されます。

• 「アプリが応答していません」などのメッセージが表示される。「エラーが発生しました」または「リクエストを処理できません」と表示される。
• アプリが想定どおりに動作しない。
• メッセージが表示されず、アプリが応答しません。

カードがエラーを返すと、次のように表示されます。

• カードの一部（ウィジェットやコンポーネントなど）が表示されない、または予期しない方法でレンダリングされる。
• カード全体が表示されない。
• ダイアログが閉じたり、開かなかったり、読み込まれなかったりする。

Chat UI にエラー メッセージが表示されない場合でも、Chat 用アプリのエラー ロギングが有効になっている場合は、エラーの修正に役立つ説明的なエラー メッセージとログデータを利用できます。

Google Chat のエラーのデバッグとトラブルシューティング

1. エラー ロギングを有効にして、エラーが発生したときに Google Chat 用アプリがエラーを記録するようにします。
2. Google Chat のエラーログをクエリすると、エラーログを読み取り、エラーの発生頻度を確認し、エラーの修正に役立つ説明的なエラー メッセージとログデータを読み取ることができます。
3. 一般的なエラーの修正方法は次のとおりです。
   • 「アプリが応答していません」、「Google Chat API の使用は Google Workspace ユーザーに限られます」、「ユーザーをスペースから除外できます」などの Google Chat アプリのエラーを修正します。
   • カード メッセージ、ダイアログ、リンクのプレビューが想定どおりにレンダリングされない、または機能しないなどのカードとダイアログのエラーを修正します。
4. Chat 用アプリをデバッグして、ステップごとに実行します。