このセクションでは、Chat 用アプリのビルドおよびテスト中に発生する可能性のある一般的な問題について説明します。
カード メッセージ、ダイアログ、リンク プレビューが表示されない、または想定どおりに機能しない
カードエラーのトラブルシューティングについては、カードのトラブルシューティングと修正をご覧ください。
アプリが応答していません
Chat アプリにメッセージを送信しても「アプリが応答していません」という応答が返ってくる場合は、 Chat 用アプリの構成を確認します。
Google Cloud コンソールで [メニュー] をクリックします。 > その他のプロダクト > Google Workspace > プロダクト ライブラリ > Google Chat API > [管理] > [構成]。
[アプリのステータス] で [公開 - ユーザーが利用可能] が選択されていることを確認します。
[インタラクティブ機能] で、設定がアプリの機能に適したものであることを確認します。Chat アプリでユーザーとやり取りする場合は、[EnableInteractive features] をオンにします。
- アプリがメッセージに反応する場合は、[1:1 のメッセージを受信する] を選択してください。
- [Connection settings] で、[App URL]、[Apps Script プロジェクトのDeployment ID]、[Cloud Pub/Sub Topic Name]、または Dialogflow エージェントが正しく設定され、デプロイされていることを確認します。
- [公開設定] で、適切なユーザーが、Google Workspace ドメイン内のメールアドレスまたはグループを使用してアプリにアクセスできることを確認します。アプリが Google Workspace Marketplace SDK でデプロイされる場合、Google Workspace Marketplace の設定が優先されるため、公開設定は必要ありません。
アプリが Google Workspace Marketplace SDK で公開されている場合は、Google Workspace Marketplace の設定を確認します。
[保存] をクリックします。
もう一度アプリにメッセージを送信してみます。
Google Chat API の使用は Google Workspace ユーザーに限られます。
Chat 用アプリの構成時に、
エラー Google Chat API is only available to Google Workspace users。このメッセージ
の設定に使用した Google アカウントが
Chat API は Google Workspace 組織の一部ではありません。独自の
Chat API を使用する場合は、
Google Workspace
。
なお、Google Chat ユーザーは、 作成する必要があります。ユーザーがコンテンツを見つけてインストールする方法について詳しくは、 Chat 用アプリについては、公開 Google Chat アプリ。
ユーザーをスペースから除外できる
Google Workspace 管理者がユーザーによるチャットの履歴のオンとオフの切り替えを禁止している場合、ユーザーレベルの設定（チャットの履歴を強制的にオンまたはオフにするユーザーレベルの設定と、組織レベルの強制設定を継承するスペースとの間に競合）により、ユーザーがスペースに参加できない、またはスペースに留まらないことがあります。
たとえば、ユーザーの [チャットの履歴] の設定が強制的に「オン」になっている場合などです。スペースのチャット履歴設定が強制的に「オフ」になっている場合、そのユーザーはスペースに参加できない可能性があります。また、競合前に参加していたユーザーが競合後にスペースにメッセージを投稿した場合、そのユーザーはスペースから削除される可能性があります。
このシナリオと、履歴設定間に競合があるその他のシナリオでは、Chat API がメンバーシップを作成できないことがあります。また、ユーザー認証を使用してメッセージを作成すると、チャット履歴設定が競合する認証済みユーザーがスペースから削除される可能性があります。
詳しくは、Google Workspace 管理者用ヘルプセンターのユーザーをスペースから除外できるをご覧ください。
Google Apps Script の拡張チャット サービスのトラブルシューティング
詳細については、Apps Script のページで 高度なチャット サービス。
ユーザーがスペースに Chat 用アプリを追加できない
ユーザーにエラー メッセージが表示される場合
This organization's administrator must allow users to install this Chat app
スペースに Chat 用アプリを追加しようとすると、
考えられる理由は次のとおりです。
- 組織で Chat 用アプリが無効になっている。
- 組織はこの特定のルールを Chat 用アプリを組織の許可リストに追加する。
ユーザーが Gemini Chat を操作しようとしたときにこのエラー メッセージが表示された場合、 組織が原因である可能性があります。 の下位組織部門に対してアクセス権を付与せずに、 割り当てられています
この問題の解決方法については、 ユーザーに Chat 用アプリのインストールを許可する。
Cloud Functions の関数のエラーのトラブルシューティング
Chat 用アプリが Cloud Functions を使用して実装されている場合、 動作しない場合は、以下のセクションを参照して、問題のトラブルシューティングと解決を行ってください。
Cloud Functions のログを確認する
まず、Cloud Functions のログでエラーを確認します。
Google Cloud コンソールで、[Cloud Functions] ページに移動します。
ログを開くには、Chat 用アプリの Cloud [関数] をクリックし、 アクションを表示 > ログを表示。
ログ エクスプローラが開き、次のような Cloud Functions のログを表示するクエリが実行されます。 エラーになります。
ログに記録されるデフォルトの情報だけではアプリをデバッグするのに十分でない場合は、 Cloud Functions コードから追加のロギングを実行できます。詳細については、Cloud 関数のログ。
Cloud Functions のエラーを確認する
ログとは別に、Cloud Functions の関数は、呼び出し中に発生したエラーを できます。
Google Cloud コンソールで、[Cloud Functions] ページに移動します。
Chat 用アプリの Cloud Functions の関数をクリックします。
[関数の詳細] ページの [エラー] にエラーが表示されます。
エラーをさらにトラブルシューティングするには、エラーをクリックします。
Cloud Functions の一般的なエラーを修正する
コンテナ イメージのビルド時に、次のエラーが発生することがあります。 Cloud Functions を使用する Chat アプリ。
プロジェクト PROJECT_NAME のリージョン REGION_NAME に関数 ChatApp がすでに存在します
Cloud Functions の関数をデプロイすると、Function
ChatApp in region REGION_NAME in project PROJECT_NAME already
exists というエラーが発生することがあります。このメッセージは、同じ名前の Cloud Functions 関数が
同じです名前を変更します。
関数を再度デプロイしますChat 用アプリでトリガー URL が使用されていることを確認する
既存の Cloud Functions の関数のトリガー URL ではなく、Cloud Functions の関数に対して作成されます。
ポリシーで指定されたユーザーの 1 人以上が、許可された顧客に属していません
Cloud Functions の関数をデプロイすると、The operation
cannot be completed on the function: "One or more users named in the policy do
not belong to a permitted customer." というエラーが発生することがあります。このエラーが発生した場合、
Chat 用アプリで、Google Chat アプリが
Chat は Cloud Functions の関数をホストしているサーバーにアクセスできません。このメッセージは
「allUsers」という名前のユーザーCloud Functions の関数を呼び出す権限がありません。
「allUsers」権限を付与する「Cloud Functions 起動元」ロールとは、Cloud
アプリの基盤となる機能が一般公開されていて、
あります。ロールの割り当て方法については、このモジュールの
単一のロールを付与する。
このエラーは、Google Cloud プロジェクトがドメイン限定されていることを示している可能性があります。対象 ドメインの制限に関する詳細は、このモジュールの ドメイン別の ID の制限
この問題を解決するには、Cloud Functions の関数が未認証のアクセスを許可することを確認します。 呼び出すことができます。既存のサービス アカウントに対する未認証の呼び出しを許可する方法を 詳細については、このモジュールの 公開（未認証）アクセスを許可する。