このページでは、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 組織のアクセスを構成するをご覧ください。
信頼できるテスターを追加する
インタラクティブな 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 アプリをスペースに追加する
インタラクティブ機能のテストを始めるには、ダイレクト メッセージ、グループ メッセージ、名前付きスペースなど、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 アプリを配布して共有するには、Chat アプリを構成して Google Workspace Marketplace に公開する必要があります。詳しくは、Google Chat アプリを公開するをご覧ください。
Google Workspace Marketplace で Chat アプリを一般公開する場合は、Chat アプリを審査に送信する必要があります。Google は、Chat アプリが Marketplace のすべての要件を満たしていることを確認します。プロセスと要件については、Google Workspace Marketplace のアプリ審査プロセスと要件をご覧ください。
関連トピック
- Google Chat アプリのデプロイを作成、管理する
- Google Chat のエラーのトラブルシューティングと修正
- Google Chat アプリのエラーログをクエリする
- Google Chat アプリを公開する