このページでは、Google Chat アプリのテスト版を構成してインストールし、Chat 用アプリのコマンド、ダイレクト メッセージ、リンクのプレビューなどのインタラクティブ機能をエンドユーザーにリリースする前に試す方法について説明します。
Chat 用アプリをテストすることで、高品質のユーザー エクスペリエンスを提供し、期待どおりに機能することを確認できます。Chat 用アプリを一般公開する場合は、テストを実施することで、Chat 用アプリが Google Workspace Marketplace に掲載されるための要件を満たしていることを確認できます。
Chat 用アプリのライフサイクルの各フェーズで安全にテストするには、開発環境、ステージング環境、本番環境を別々に設定することをおすすめします。各環境で、異なる Chat 用アプリを作成してデプロイする必要があります。環境の設定方法については、Google Chat 用アプリのデプロイを作成して管理するをご覧ください。
前提条件
-
インタラクション イベントを受け取って応答するように構成された Google Chat 用アプリ。インタラクティブな Chat 用アプリを作成するには、使用するアプリのアーキテクチャに基づいて、次のいずれかのクイック スタートを完了します。
- Google Cloud Functions を使用した HTTP サービス
- Google Apps Script
- Google Cloud Dialogflow CX
- Google Cloud Pub/Sub
テスト用に Chat 用アプリへのアクセス権を付与するには:
chat.owner
IAM ロールが必要です。このロールは、Chat 用アプリに関連付けられた Google Cloud プロジェクトの編集者またはオーナーとして設定することもできます。詳細については、Google Cloud ドキュメントの Google Cloud コンソールを使用して IAM ロールを付与するをご覧ください。- Chat 用アプリをテストするユーザーは、Chat 用アプリが構成されている同じ Google Workspace 組織に属している必要があります。
Google Workspace 組織で Chat 用アプリをテストしてインストールできることを確認します。詳しくは、Google Workspace Marketplace のドキュメントの Google Workspace 組織のアクセス権を構成するをご覧ください。
Trusted Tester を追加する
インタラクティブな Chat 用アプリの場合、Chat API を使用すると、Google Workspace 組織内の特定のユーザーと Chat 用アプリを共有できます。指定したユーザーは、Chat 用アプリをスペースに追加して、Marketplace に公開する前に機能をテストできます。独自の Chat 用アプリをテストするには、自分自身を信頼できるテスターとして追加する必要があります。
テスト用の Chat 用アプリを組織内のユーザーが利用できるようにするには、Google Cloud コンソールで Chat API の [可視性] 設定を更新します。
- Google Cloud コンソールで、Google Chat API ページを開きます。
- [構成] タブをクリックします。
- [インタラクティブ機能] > [公開設定] に移動し、[
GOOGLE_WORKSPACE_ORGANIZATION
内の特定のユーザーおよびグループにこの Chat 用アプリの利用を許可する] を選択します。ここで、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 を開きます。
- Chat 用アプリでダイレクト メッセージを開始するには、次の操作を行います。
- [ 新しいチャット] をクリックします。
- [ユーザーを 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 にアプリを公開するをご覧ください。
Chat 用アプリを Google Workspace Marketplace で一般公開する場合は、審査のために Chat 用アプリを送信する必要があります。Google は、Chat 用アプリが Marketplace の要件をすべて満たしているかどうかを審査します。プロセスと要件については、Google Workspace Marketplace のアプリ審査プロセスと要件をご覧ください。
関連トピック
- Google Chat 用アプリのデプロイを作成して管理する
- Google Chat のエラーのトラブルシューティングと修正
- Google Chat アプリのエラーログをクエリする
- Google Workspace Marketplace にアプリを公開する