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. [構成] タブをクリックし、次の必要な情報を入力します。

    • アプリ名: ユーザーが 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 に記録するには、[Log errors to Logging] チェックボックスをオンにします。詳細については、Chat アプリのエラーログをクエリするをご覧ください。

  5. [保存] をクリックします。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 です。