作成する各 Google Chat アプリには、Chat API を有効にして構成した独自の Google Cloud プロジェクトが必要です。このページでは、Chat API の構成方法について説明します。
前提条件
- Google Chat へのアクセス権を持つ Google Workspace アカウント。
- Google Cloud プロジェクト。
- OAuth 同意画面を構成する
- Google Chat API を有効にする
Chat API を構成する
Google Cloud コンソールで「Google Chat API」を検索し、[Google Chat API]、[管理] の順にクリックします。
[構成] タブをクリックし、次の必要な情報を入力します。
- アプリ名: ユーザーが Chat 用アプリを操作するときに使用する名前。
- アバター URL: Chat アプリのアバターとして表示される 128x128 以上の正方形のグラフィック画像(PNG や JPEG など)を指す HTTPS URL。
- 説明: Chat アプリの本来の目的の説明。Chat アプリの名前の下に表示されます。
インタラクティブ機能を有効にするには、[インタラクティブ機能を有効にする] トグルをクリックして、ユーザーが Chat アプリを操作できるようにします。次の表を使用して構成を完了します。
項目 説明 機能 Chat 用アプリでユーザーとやり取りする方法を決定する一連のフィールド: - 1 対 1 のメッセージの受信: Google Chat で直接 Chat 用アプリを見つけてメッセージを送信できます。
- スペースやグループの会話に参加する: スペースやグループの会話に Chat アプリを追加できます。
接続設定 Chat アプリのエンドポイント。次のいずれかです。 - アプリの URL: Chat 用アプリの実装をホストする HTTPS エンドポイント。
- Apps Script プロジェクト: Chat 用アプリを実装する Apps Script プロジェクトのデプロイ ID。
- Cloud Pub/Sub トピック名: Chat アプリがエンドポイントとしてサブスクライブする Pub/Sub トピック。
- Dialogflow: Dialogflow とのインテグレーションに Chat アプリを登録します。詳細については、自然言語を理解する Dialogflow Google Chat アプリを構築するをご覧ください。
スラッシュ コマンド Google Chat 内でユーザーに提示できるコマンド。ユーザーは Google Chat 内で Chat 用アプリの主要なアクションを確認し、操作したい特定のアクションを選択できます。詳細については、Chat 用アプリとしてスラッシュ コマンドに応答するをご覧ください。 リンク プレビュー Chat アプリが認識し、ユーザーがリンクを送信する際に追加のコンテンツを提供する URL パターン。詳細については、プレビュー リンクをご覧ください。 公開設定 Chat 用アプリを表示してインストールできる最大 5 人または 1 つ以上の Google グループ。このフィールドを使用して、Chat 用アプリをテストしたり、Chat 用アプリをチームと共有したりできます。詳しくは、Chat 用アプリの公開設定と公開設定をご覧ください。 Chat アプリがエラーを返すたびにエラーを Cloud Logging に記録するには、[Log errors to Logging] チェックボックスをオンにします。詳細については、Chat アプリのエラーログをクエリするをご覧ください。
[保存] をクリックします。Chat アプリの構成を保存すると、Google Workspace 組織内の指定したユーザーが Chat アプリを使用できるようになります。
Chat 用アプリを構成する権限を他のユーザーに付与する
Chat アプリの構成ページへのアクセス権を特定のユーザーに付与できます。Chat アプリのオーナーと Chat アプリの閲覧者の IAM ロールを使用します。これらのロールを持つユーザーは、[API とサービス] ダッシュボードを使用して Chat アプリの構成ページに移動することはできませんが、次のように Google Cloud コンソールで Chat アプリのホスト Cloud プロジェクトの構成ページに移動できます。
https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID
ここで、PROJECT_ID
は Chat アプリをホストする Google Cloud プロジェクトのプロジェクト ID です。