このページでは、インタラクティブな Google Chat アプリを構築する方法の概要について説明します。インタラクティブな Chat アプリは、Google Chat を拡張する Google Workspace アドオンとして構築されます。
インタラクティブ Chat 用アプリを使用すると、ユーザーは次の操作を行うことができます。
- Chat スペースまたはダイレクト メッセージに Chat 用アプリを追加します。
- テキスト、カード、インタラクティブ UI 要素を含む Chat 用アプリとの間でメッセージを送受信します。
- Chat 用アプリとの 1 対 1 のダイレクト メッセージの [ホーム] タブで、アプリホームカードを表示して操作します。
- スラッシュ コマンド、クイック コマンド、メッセージ アクションを使用して Chat 用アプリをプロンプトします。
- Chat のメッセージからリンクをプレビューし、会話を離れずにアクションを実行できます。
- Chat 用アプリに情報を送信します（ダイアログやカード メッセージにテキストを入力するなど）。
- Google Workspace アプリケーション全体でタスクを自動化または実行し、外部のツールやサービスに接続します。
ユーザーが双方向の Chat 用アプリを見つけて使用する方法
Chat では、Chat を拡張するアドオンは Google Chat アプリとしてユーザーに表示されます。ユーザーは、次のようなさまざまな方法で、Marketplace に公開された Chat 用アプリを見つけて使用できます。
- Google Chat または Marketplace から Chat 用アプリを検索してインストールします。
- Chat スペースに追加された Chat 用アプリを操作する。
- Google Workspace 管理者がユーザーの代わりに Chat 用アプリをインストールすると、ダイレクト メッセージ パネルに Chat 用アプリが表示されます。
Chat 用アプリの使用を開始するには、Google Chat ユーザーが Chat 用アプリとのダイレクト メッセージを開始するか、スペースに Chat 用アプリを追加します。ユーザーは、Chat 用アプリを名前リンクで追加することもできます。詳しくは、Chat 用アプリを使用するをご覧ください。
次の例は、ユーザーが Chat 用アプリを @メンションしてスペースに追加する方法を示しています。
始める
インタラクティブな Chat 用アプリの作成を開始するには、次のドキュメントをご覧ください。
- Google Chat API を構成し、Chat 用アプリのインタラクティブ機能を有効にします。
- トリガー、イベント オブジェクト、アクションを使用してユーザー インタラクションを受け取って応答する方法を学びます。
- クイック スタートを試して、お好みの Google Chat アプリのアーキテクチャ用の基本的な Chat 用アプリを作成します。
基本的な Chat 用アプリを構成して作成する
次の表に、各 Google Chat アプリのアーキテクチャで Chat API を構成し、基本的なインタラクティブ Chat 用アプリを作成するためのドキュメントを示します。
| アーキテクチャまたはタスク | ガイド |
|---|---|
| Chat API を構成する | Google Chat API を構成する |
| クイックスタート | |
| Apps Script | Apps Script を使用して Chat 用アプリを作成する |
| HTTP サービス（Cloud Run functions） | HTTP Chat 用アプリを作成する |
| Pub/Sub | Pub/Sub を使用して Chat 用アプリを構築する |
| Dialogflow CX | Dialogflow CX Chat 用アプリを作成する |
| Dialogflow ES | Dialogflow ES Chat 用アプリを構築する |
| Agent Development Kit（ADK）AI エージェント | ADK AI エージェントの Chat 用アプリを構築する |
| Agent2Agent（A2A）AI エージェント | A2A AI エージェントの Chat 用アプリを構築する |
| A2UI AI エージェント | A2UI AI エージェントの Chat 用アプリを構築する |
| Gemini Enterprise AI エージェント | Gemini Enterprise AI エージェントの Chat 用アプリを構築する |
インタラクティブな機能を構築する
次の表に、インタラクティブな Chat 用アプリの機能を構築するためのドキュメントを示します。
| 機能 | ガイド |
|---|---|
| ユーザー インタラクションを受け取って応答する | ユーザー インタラクションを受け取って応答する |
| メッセージを送信する（やり取りに返信する、またはプロアクティブに送信する） | メッセージで返信するまたは Chat API を使用してメッセージを送信する |
| スラッシュ コマンド、クイック コマンド、メッセージ アクションに応答する | コマンドに応答する |
| インタラクティブなダイアログを構築する | インタラクティブ ダイアログを開く |
| カードとダイアログから情報を収集して処理する | カード上のユーザーが入力したフォームデータを読み取る |
| Chat メッセージ内のリンクをプレビューする | プレビュー リンク |
| 1 対 1 のダイレクト メッセージにホームページ（アプリのホーム）を作成する | Chat 用アプリのホームページを作成する |
| 外部システムとツールに接続する | Chat 用アプリを他のサービスやツールに接続する |
Google Workspace アドオンの制限事項と考慮事項
Chat アプリは Chat を拡張する Google Workspace アドオンとして構築されるため、次の機能制限に注意してください。
- AppSheet Google Workspace アドオンとしてビルドする場合、Chat 用アプリのアーキテクチャは使用できません。代わりに、HTTP サービス、Apps Script、Dialogflow ES、Dialogflow CX、または Pub/Sub を使用して Chat 用アプリを構築します。
- Chat ではカスタム認証カードはサポートされていません。Chat からサービスを認証して認可を付与するには、Chat 用アプリが基本認証カードを返す必要があります。
- Chat のサイドバーのアドオンのホームページはサポートされていません。マニフェスト（
addons.common.homepageTrigger）でホームページ トリガーを構成している場合、ホームページはアドオンが拡張する他の Google Workspace アプリケーションのサイドバーにのみ表示されます。代わりに、Chat アプリとの 1 対 1 のダイレクト メッセージの [ホーム] タブに表示される Chat 用アプリのホームページを作成できます。
既存の Google Workspace アドオンを拡張して Chat で動作させる場合は、Chat 用アプリの次の構成要件を考慮してください。
- Google Workspace Marketplace のインストール設定で、個人と Google Workspace 管理者の両方がアドオンをインストールできるようにする必要があります。
- アドオンのマニフェスト（
addons.common）にある共通の構成設定は、Chat では無視されます。Chat で動作するようにアドオンを構成するには、Chat API を有効にして構成する必要があります。手順については、Google Chat API を構成するをご覧ください。 - Chat でアドオンをデプロイしてテストするには、Chat API の公開設定を使用する必要があります。Google Workspace Marketplace SDK で構成した公開設定やテスト設定はすべて無視されます。Chat にアドオンのテスト版をデプロイするには、Google Chat アプリのインタラクティブ機能をテストするをご覧ください。
- アドオンが Google Workspace Marketplace に公開されている場合、Google Chat API 構成設定の変更の下書きを保存することはできません。Chat API の構成設定を更新すると、更新された Chat 用アプリが既存のすべてのユーザーにすぐに利用可能になります。マーケットプレイスのリスティングを更新するには、変更を送信する前に下書きを作成できます。
関連トピック
アドオンではない Chat 用アプリ: インタラクティブな Google Chat 用アプリを作成する
Google Workspace アドオンではない Chat 用アプリは、Google Workspace アドオンのイベント オブジェクト（EventObject）とアクションではなく、Chat API のインタラクション イベント（Event）を受け取る Chat 専用アプリとして構築されます。
アドオンではない Chat 用アプリを管理している場合は、次のことができます。
- アドオンではない Chat 用アプリを、Google Chat を拡張する Google Workspace アドオンに変換します。Google Chat アプリを Google Workspace アドオンに変換するをご覧ください。
- リクエストとレスポンスの形式については、このドキュメント セットの各インタラクティブ機能ガイドの下部にある展開可能なアドオンではないチャットアプリのセクションを参照してください。