作成したチャットアプリを公開すると、そのユーザー、グループ、Google Workspace 組織内のすべてのユーザー、または Google Workspace アカウントを持つすべての Google Chat ユーザーが選択できるようになります。
ユーザーが Google Chat アプリを見つけて使用する方法
Google Chat アプリを見つけるには、次のいずれかの操作を行います。
- Google Chat でアプリを検索してインストールします。
- Chat スペースに追加されているアプリを操作します。
- Google Workspace 管理者がユーザーに代わってアプリをインストールすると、ダイレクト メッセージ パネルにアプリが表示されます。
Google Chat ユーザーは、アプリを使用してダイレクト メッセージを開始するか、アプリをスペースに追加することで、アプリの使用を開始できます。名前リンクを付けてアプリを追加することもできます。次の例は、@ ユーザーが Chat アプリに名前リンクを付けてスペースに追加する方法を示しています。
また、Google Workspace 管理者は Google Workspace Marketplace でチャットアプリを見つけ、組織内のユーザーにアプリをインストールすることもできます。管理者が Chat アプリをインストールすると、ユーザーのダイレクト メッセージ パネルにそのアプリが表示されます。
Google Workspace 管理者は、Google Workspace 組織での Chat アプリの使用を管理、許可リストに登録することもできます。許可リストを使用する組織向けの Chat アプリを開発している場合は、ユーザーがアプリを見つけて使用できるように、許可リストに Chat のアプリを追加するよう管理者にリクエストする必要があります。詳しくは、Google Workspace 管理者用ヘルプのドキュメントでユーザーに Chat 用アプリのインストールを許可するをご覧ください。
Google Cloud コンソールを使用してチャットアプリを構成して公開する
一般に、チャットアプリを公開して他のユーザーが利用できるようにするには、次の手順を行う必要があります。
- Google Chat API を有効にして構成します。API を構成すると、テスト目的で他の Google Chat ユーザーにチャットアプリへのアクセス権を付与します。
- Google Workspace Marketplace SDK を使用してアプリを公開します。Google Workspace 組織のユーザーまたはすべての Google Chat ユーザーがチャットアプリを利用できるように構成できます。
- Google Workspace 組織がチャットアプリへのアクセスを管理している場合は、アプリを組織の許可リストに追加するよう Google Workspace 管理者に依頼します。
Chat アプリの公開設定と公開設定
次の表に、Chat アプリのユーザー層に基づいて Google Chat API と Google Workspace Marketplace SDK の設定を構成する方法を示します。
. . . .| Chat アプリを作成しています... | 認証方法 | Google Chat API の設定 | Google Workspace Marketplace SDK の設定 | Chat アプリはどこで公開されていますか？ |
|---|---|---|---|---|
| 小さいチームの場合 | ユーザーまたはアプリとして認証します。 | [公開設定] 設定で、アプリにアクセスできるユーザーや Google グループを指定します。
Google Workspace アカウントでアプリを許可リストに登録する必要がある場合は、最大 5 つのメールアドレスのみ指定できます（Google グループを指定することはできません）。 |
チャットアプリ用に Google Workspace Marketplace SDK を構成する必要はありません。 | チームメンバーは Google Chat でチャットアプリを見つけて使用できます。 |
| ...大規模なチームの場合 | ユーザーまたはアプリとして認証します。 | [公開設定] 設定で、Chat アプリをテストするユーザーや Google グループを指定します。
テストが終了したら、Google Workspace Marketplace SDK の設定を使用して Chat アプリを Google Workspace 組織に公開します。 |
[アプリの公開設定] を [非公開] に設定します。 [インストール設定] を [個人 + 管理者] に設定します。 Google Workspace アカウントでアプリを許可リストに登録する必要がある場合は、管理者が Chat アプリを許可リストに追加して、ユーザーがアプリを見つけて使用できるようにします。詳細については、Google Workspace 管理者用ヘルプのドキュメントでユーザーに Chat アプリのインストールを許可するをご覧ください。 |
Google Workspace を利用しているすべてのユーザーが、Google Chat で Chat アプリを見つけてインストールしたり、Google Workspace Marketplace でアプリを表示したりできます。ユーザーと Google Workspace 管理者は、Marketplace からアプリをインストールできます。 |
| ...Google Workspace 組織の場合 | ユーザーまたはアプリとして認証します。 | [公開設定] 設定で、Chat アプリをテストするユーザーや Google グループを指定します。
テストが終了したら、Google Workspace Marketplace SDK の設定を使用して Chat アプリを Google Workspace 組織に公開します。 |
[アプリの公開設定] を [非公開] に設定します。 [インストール設定] を [個人 + 管理者] に設定します。 |
Google Workspace を利用しているすべてのユーザーが、Google Chat で Chat アプリを見つけてインストールしたり、Google Workspace Marketplace でアプリを表示したりできます。Marketplace からアプリをインストールできるのは、Google Workspace 管理者のみです。 |
| ...すべてのユーザー（公開チャットアプリ） | アプリとして認証します。 | [公開設定] 設定で、Chat アプリをテストするユーザーや Google グループを指定します。 テストが終わったら、Google Workspace Marketplace の設定を使用して Chat アプリを一般公開します。 |
[アプリの公開設定] を [一般公開] に設定します。 [インストール設定] を [個人 + 管理者] に設定します。 |
すべての Google Workspace ユーザーは、Google Chat で Chat アプリを見つけてインストールし、Google Workspace Marketplace でアプリを表示できます。Marketplace からアプリをインストールできるのは、Google Workspace 管理者のみです。 |
Google Chat API を有効にして設定する
Google API Console でアプリ用のプロジェクトを設定し、Google Chat API を有効にします。
- 下のボタンを使用して、新しいプロジェクト（または既存のプロジェクトを選択）を作成し、そこにサービス アカウントを追加します。サービス アカウントにプロジェクト オーナーのロールを付与します。
API を有効にする - ダウンロードした JSON キーを保存します。アプリは、このキーを使用して、スペースに非同期に送信されるメッセージを認証できます。
- API Console でプロジェクトを開きます。API のリストで、[Google Chat API] をクリックします。
- [Configuration] タブを選択し、次の表の説明に沿ってアプリの情報を入力します。
アプリの構成を保存すると、Google Workspace 組織内の指定されたユーザーがそのアプリを利用できるようになります。
Google Chat API の設定
| Field | 説明 |
|---|---|
| アプリ名 | アプリを操作するときに使用される名前です。 |
| アバターの URL | 128x128 以上の正方形のグラフィック画像（PNG や JPEG など）を指す HTTPS URL を指定します。アプリのアバターとして表示されます。 |
| 説明 | アプリの名前。アプリ名の下に表示され、 |
| 機能 | アプリをトリガーするイベントを決める一連のフィールドは次のとおりです。
|
| 接続設定 | アプリのエンドポイント。次のいずれかです。
|
| スラッシュ コマンド | Google Chat でユーザーに表示できるコマンド。ユーザーは、Google Chat 内でアプリの重要なアクションを表示し、操作する特定のアクションを選択できます。 |
| リンク展開 | アプリが認識し、ユーザーがリンクを送信したときに追加コンテンツを提供する URL パターン。詳しくは、リンクの展開を解除するをご覧ください。 |
| 公開設定 | Chat アプリを表示、インストールできる最大 5 人または 1 つ以上の Google グループ。アプリをテストしたり、チームと共有したりするには、このフィールドを使用します。詳しくは、Chat アプリの公開設定と公開設定をご覧ください。 |
アプリの設定権限を付与する
特定のユーザーにアプリの設定ページへのアクセス権を付与できます。これを行うには、チャットアプリ オーナーとチャットアプリ閲覧者の IAM ロールを使用します。これらのロールを持つユーザーは、[API とサービス] ダッシュボードからアプリの構成ページに移動することはできませんが、プロジェクトのコンソールに移動して、次のように構成ページにアクセスできます。
https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=your-project-id
Google Workspace Marketplace SDK を使用してアプリを公開する
Google Workspace Marketplace SDK を使用して以下のことを行う
- アプリを一般公開し、Google Chat のユーザーがチャットアプリをスペースに追加できるようにします。
- アプリをドメインに公開します。
- Google Workspace 管理者にアプリを公開して、組織内のユーザーにアプリをインストールしてもらいます。 アプリが Google Workspace 管理者に表示されるには、ダイレクト メッセージを表示する必要があります。
Google Workspace Marketplace SDK を使用してアプリを公開する前に、次の手順を実施します。
- Chat からインストールしてチャットアプリをテストします。アプリが完全に機能し、進行中の作業ではないことを確認します。
- パブリケーションの要件をチェックし、アプリがすべての要件を遵守していることを確認します。詳しくは、審査の領域をご覧ください。
- アプリのバージョン番号を記録します。これは、Google Workspace Marketplace SDK を構成するために必要です。
公開する準備ができたら、概要: アプリを公開するをご覧ください。
チャットアプリを無効にする
構成ページを保存すると、[アプリのステータス] フィールドが表示されます。このフィールドで、アプリをライブと無効のどちらにするかを制御できます。
Chat アプリを無効にするには:
- Google Cloud コンソールを開きます。
- 必要に応じて、Chat アプリをホストする Google Cloud プロジェクトを選択します。
- [Google Cloud] の横にある下矢印 をクリックします。現在のプロジェクトを一覧表示するダイアログが表示されます。
- 移行された Chat アプリをホストするプロジェクトを選択します。
- [開く] をクリックします。
- 「Google Chat API」を検索し、[Google Chat API] をクリックします。
- [管理] をクリックします。
- [構成] をクリックします。
- [アプリのステータス] で [無効] を選択します。
- [保存] をクリックします。