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

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

エラーの表示方法

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

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

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

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

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

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

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