Google Chat API を構成する

作成する Google Chat アプリごとに、Chat API を有効にして構成した独自の Google Cloud プロジェクトが必要です。このページでは、Chat API の構成方法について説明します。

前提条件

Chat API を構成する

  1. Google Cloud コンソールで「Google Chat API」を検索し、[Google Chat API]、[管理] の順にクリックします。

    Chat API に移動

  2. [Configuration] タブをクリックし、次の必要な情報を入力します。

    • アプリ名: Chat アプリの操作時に使用する名前。
    • アバター URL: Chat アプリのアバターとして表示される、128x128 以上の正方形のグラフィック画像（PNG や JPEG など）を指す HTTPS URL。
    • 説明: Chat アプリの名前の下に表示される、Chat アプリの本来の目的の説明。

  3. インタラクティブ機能をオンにするには、[インタラクティブ機能を有効にする] 切り替えボタンをクリックして、ユーザーが 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 アプリの公開設定と公開の設定をご覧ください。

  4. Chat アプリがエラーを返すたびにエラーを Cloud Logging に記録するには、[Logging にエラーを記録する] チェックボックスをオンにします。詳細については、Chat アプリのエラーログのクエリをご覧ください。

  5. [保存] をクリックします。Chat アプリの構成を保存すると、Google Workspace 組織内の指定したユーザーが 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 です。