Google Chat アプリのインタラクティブ機能をテストする

このページでは、Google Chat アプリのテスト版を構成してインストールし、エンドユーザーにリリースする前に、Chat アプリのコマンド、ダイレクトメッセージ、リンクのプレビューなどのインタラクティブな機能を試す方法について説明します。

Chat アプリをテストすることで、高品質のユーザーエクスペリエンスを提供し、期待どおりに機能することを確認できます。Chat アプリを一般公開する場合は、テストで Google Workspace Marketplace に掲載するための要件を満たしていることを確認できます。

Chat アプリのライフサイクルの各フェーズで安全にテストを行うには、開発環境、ステージング環境、本番環境を別々に設定することをおすすめします。各環境で、異なる Chat アプリを作成してデプロイする必要があります。環境の設定方法については、Google Chat アプリのデプロイを作成して管理するをご覧ください。

前提条件

インタラクションイベントを受信して応答するように構成された Google Chat アプリ。インタラクティブな Chat アプリを作成するには、使用するアプリのアーキテクチャに基づいて、次のいずれかのクイックスタートを完了します。
- HTTP サービス with Google Cloud Functions
- Google Apps Script
- Google Cloud Dialogflow CX
- Google Cloud Pub/Sub
テスト用に Chat アプリへのアクセス権を付与するには:
- chat.owner IAM ロールが必要です。このロールは、Chat アプリに関連付けられた Google Cloud プロジェクトの編集者またはオーナーとして付与することもできます。詳しくは、Google Cloud ドキュメントのGoogle API Consoleを使用して IAM ロールを付与するをご覧ください。
- Chat アプリをテストするユーザーは、Chat アプリが構成されている Google Workspace 組織に属している必要があります。
Google Workspace 組織で Chat アプリをテストしてインストールできることを確認します。詳しくは、Google Workspace Marketplace ドキュメントの Google Workspace 組織のアクセス権を構成するをご覧ください。

信頼できるテスターを追加する

インタラクティブな Chat アプリの場合、Chat API を使用すると、Google Workspace 組織内の特定のユーザーと Chat アプリを共有できます。指定したユーザーは、Marketplace に公開する前に、Chat アプリをスペースに追加して機能をテストできます。自分の Chat アプリをテストするには、自分を信頼できるテスターとして追加する必要があります。

テスト用の Chat アプリを組織内のユーザーが利用できるようにするには、Google API Console で Chat API の [公開設定] を更新します。

Google API Console で、Google Chat API のページを開きます。
Google Chat API のページに移動
[構成] タブをクリックします。
[インタラクティブ機能] > [公開設定] に移動し、 [`GOOGLE_WORKSPACE_ORGANIZATION` 内の特定のユーザーおよびグループにこの Chat 用アプリの利用を許可する] GOOGLE_WORKSPACE_ORGANIZATION を選択します。ここで、 GOOGLE_WORKSPACE_ORGANIZATION は組織の名前です。
チェックボックスをオンにすると表示されるフィールドに、Chat アプリにアクセスするユーザーまたは Google グループのメールアドレスをカンマ区切りで入力します。自分の Chat アプリをテストするには、Google Chat へのアクセスに使用するメールアドレスを入力します。
[保存] をクリックします。

スペースに Chat アプリを追加する

インタラクティブな機能のテストを開始するには、Chat アプリを 1 つ以上のスペース（ダイレクトメッセージ、グループメッセージ、名前付きスペースなど）に追加する必要があります。スペース内のすべてのメンバーを信頼できるテスターとして追加していない場合、スペースに Chat アプリが表示されても、直接操作することはできません。

公開されていない Chat アプリは、Google Workspace Marketplace の検索結果に表示されません。Google Chat で非公開の Chat アプリを見つけるには、Chat アプリを検索するか、メッセージの作成時に [Google Workspace ツール] で検索するか、メッセージで Chat アプリを @メンションします。

スペースに Chat アプリを追加する手順は次のとおりです。

信頼できるテスターとして追加したときに指定した Google Workspace アカウントを使用して Google Chat を開きます。

Google Chat に移動
Chat アプリとのダイレクトメッセージを開始する手順は次のとおりです。

[**チャットを新規作成**] をクリックします。
In the [**1 人以上のユーザーを追加**] フィールドに、Chat アプリの名前を入力します。
結果から Chat アプリを選択します。ダイレクトメッセージが開きます。

既存のスペースに Chat アプリを追加する手順は次のとおりです。

[**スペース**] で、スペースの名前をクリックします。
Chat スペースの新しいメッセージフィールドに、@ と Chat アプリの名前を入力します。結果から Chat アプリを選択します。
Enter キーを押すか、 [ 送信] をクリックします。
[追加先] スペース名ウィンドウが表示されたら、 [スペースに追加] をクリックします。@メンションを含むメッセージが Chat スペースに投稿されます。 Chat アプリをスペースに追加したことを説明するテキストも表示されます。

これで、スペースで Chat アプリをテストできます。

Chat アプリをテストする際は、すべての機能を確認し、発生したエラーを記録して修正する必要があります。エラーメッセージの内容と対処方法については、Google Chat のエラーのトラブルシューティングと修正をご覧ください。

Google Workspace Marketplace 向けの Chat アプリを確認してテストする

信頼できるテスターとして登録されていないユーザーに Chat アプリを配布して共有するには、Google Workspace Marketplace で Chat アプリを構成して公開する必要があります。詳しくは、Google Workspace Marketplace にアプリを公開するをご覧ください。

Google Workspace Marketplace で Chat アプリを一般公開する場合は、Chat アプリを審査に提出する必要があります。Google は、Chat アプリが Marketplace のすべての要件を満たしていることを確認します。プロセスと要件については、Google Workspace Marketplace のアプリ審査プロセスと要件をご覧ください。