概要

サービスやリソースを Google Chat に直接組み込む Google Chat アプリを作成することで、ユーザーは会話から離れることなく情報を取得し、操作できるようになります。

Google Chat には、チームのコラボレーションを支える機能が備わっています。

ユーザー間のダイレクトメッセージ。
スペース内のスレッド形式の会話。
プロジェクト単位、チーム単位などでディスカッションスペース専用の Chat スペース。
スペースに参加できる、またはダイレクトメッセージに応答できる Chat アプリ。

メッセージとスペース

Google Chat アプリと Chat アプリ間のやり取りは、特定のスペースのコンテキストでメッセージを使用して行われます。たとえば、Chat アプリは特定の Chat スペースにテキスト（メッセージの一種）を送信できます。

メッセージには、Chat アプリの操作、テキスト、カードが含まれます。スペースにはチャットルームとダイレクトメッセージが含まれます。

上の図は、メッセージとスペースで使用できるさまざまな種類のインタラクションとコンテキストを示しています。

Google Chat と Chat アプリ間のメッセージは、定義されたメッセージ形式に従います。各メッセージは、コンポーネントでユーザー ID、スタイル、コンテンツ、その他の要素を指定する JSON オブジェクトで構成されます。Chat アプリは、次の種類のメッセージを送信できます。
- テキストメッセージには、テキスト形式が制限された書式なしテキストコンテンツが含まれます。
- カードメッセージでは、スペースに表示されるカードの形式、コンテンツ、動作を定義します。たとえば、カードメッセージには、ユーザーから情報を収集するためのダイアログを開くリンク付きのボタンを含めることができます。
Google Chat では、スペースで次のコンテキストを利用できます。
- 名前付きスペースまたはグループスペースは複数のユーザーに表示されます。
- ダイレクトメッセージは、そのスペース内のユーザーにのみ表示されます。

ユースケース

Chat アプリを Chat のような会話型プラットフォームに追加すると、コンテキストを変更することなく、ユーザーが質問したり、コマンドを発行したりできます。Chat アプリは、バックエンドで他のシステムにアクセスし、それらのシステムの仲介役として機能します。

統合された認知エクスペリエンスを維持しながら、幅広いリソースとツールにアクセスできる機能は、次のような多くのタイプのアプリケーションのフレームワークを提供します。

ワークフロー管理
セットアップと構成
注文の生成
検索
データの収集

Chat スペース内から Chat アプリにリクエストできる操作の例を次に示します。

情報の検索 - Chat アプリは、ユーザーが入力した構造化クエリまたはフリーテキストクエリに基づいて情報を取得できます。
ファイルチケット - Chat アプリは、ユーザーが提供した情報を使用して、インシデントレポートやその他のアーティファクトを生成できます。
作業の調整 - Chat アプリを使用すると、「チームメモリ」の提供やリソースのスケジューリングなど、チームメンバー間のやり取りを強化できます。

インタラクティブな Chat アプリを作成する

多くの Chat アプリでは、ユーザーが直接 Chat アプリにメッセージを送信したり、やり取りしたりできます。インタラクティブな Chat アプリでは、次のことができます。

名前リンク、スラッシュコマンド、またはダイレクトメッセージに、テキストメッセージまたはカードメッセージで応答します。
ユーザーが複数のステップ（フォームデータの入力など）を完了できるようにダイアログを開きます。
プレビューリンク: ユーザーが会話から直接操作できるよう、役立つ情報を含むカードを追加できます。

ユーザーとやり取りするには、Chat アプリがインタラクションイベントを受信して応答できる必要があります。インタラクティブな Chat アプリを作成するには、Google Chat アプリのインタラクションイベントの受信と応答をご覧ください。

非対話型の Chat アプリを作成する

また、ユーザーが Google Chat アプリを直接操作できないものの、Chat アプリは Google Chat API を直接呼び出すため、ユーザーにとって Google Chat アプリは非対話型にすることもできます。たとえば、スペースでメッセージを送信してもユーザーが Chat アプリに応答できない Chat アプリを作成できます。このタイプの Chat アプリのアーキテクチャは、アラームレポートなどに役立ちます。詳細については、Google Chat API の概要をご覧ください。

イベントドリブンの Chat アプリを作成する

Chat アプリでは、Google Workspace Events API を使用して、Chat リソースに関するイベントに登録できます。サブスクリプションを使用すると、Chat アプリは、サブスクライブされた Google Workspace リソースに対する変更を表すイベントに関する情報を受信できます。たとえば、Chat アプリは、そのスペースに追加された新しいメンバーにウェルカムメッセージを送信するなど、Chat アプリが登録しているスペースの変更に応答できます。詳細については、Google Chat イベントに登録するをご覧ください。

Chat アプリのアーキテクチャを選択する

Chat API には、アプリを Chat スペースに統合するためのさまざまな方法が用意されていますが、Chat アプリのロジックを実装する具体的な方法は提供または指示されていません。コマンドドリブンの Chat アプリを作成することも、任意の種類の言語処理や AI サービスまたはモジュールを使用することもできます。これは、次のようなさまざまなプラットフォームで行えます。

AppSheet
Google Apps Script
Pub/Sub
Google Cloud またはオンプレミスの HTTP サーバー

詳細については、Chat アプリのアーキテクチャを選択するをご覧ください。

アプリによるユーザーデータへのアクセス

Chat アプリが呼び出された際、誰が、どのようなコンテキストで、どのように起動元を呼び出すのかを把握する必要があります。この基本的な ID データ以外のデータにアクセスするには、認証によって Chat アプリにアクセス権を付与する必要があります。

デフォルトでは、Chat アプリは、アプリを起動したユーザー、またはアプリを呼び出す同じメッセージ内で名前リンクが付けられたユーザーの基本的な ID のみを読み取ることができます。この情報には、ユーザーの表示名、ユーザー ID、メールアドレス、アバター画像が含まれます。
リンクをプレビューする Chat アプリの場合、Chat アプリは、メッセージに追加された URL が Chat アプリの構成済み URL パターンと一致するように読み取ることができます。
ユーザーに拡張機能（すべてのメッセージやスペースのメンバーリストの読み取りなど）を提供するために、Chat アプリが他のデータにアクセスする必要がある場合は、そのデータにアクセスできるように認証を設定します。ユーザーデータにアクセスする場合、Chat アプリはユーザーにアクセス権を求めるプロンプトを表示し、ユーザーがアクセスを許可する必要があります。詳細については、Chat アプリを他のサービスやツールに接続するをご覧ください。