このページでは、Google Chat を拡張する Google Workspace アドオンの構築方法の概要を説明します。
Chat を拡張する Google Workspace アドオンを使用すると、ユーザーは次の操作を行うことができます。
- チャット メッセージからのリンクをプレビューし、会話を終了せずにアクションを実行します。
- Google Workspace アプリケーション全体でタスクを自動化または実行します。
- 外部のツールやサービスに関するアラートや通知を受け取る。
Chat での Google Workspace アドオンの仕組み
Chat では、ユーザーに対してアドオンは Google Chat アプリとして表示されます。ユーザーとやり取りするために、Chat 用アプリは次のことができます。
- テキスト、カード、インタラクティブな UI 要素を含むメッセージを送信します。
- クイック コマンドに応答します。
- スラッシュ コマンドに応答します。
- ダイアログを開いて、フォームデータの入力など、複数のステップから成るプロセスをユーザーが完了できるようにします。
- 役立つ情報を含むカードを添付して、メッセージ内のリンクをプレビューし、ユーザーが会話から直接操作できるようにします。
始める
Chat で動作する Google Workspace アドオンの構築を開始するには、次のドキュメントをご覧ください。
- クイックスタートを試して、Google Apps Script または HTTP サービスを使用して基本的な Chat アプリを構築してみましょう。
- Chat API を使用して、Chat 用アプリとそのインタラクティブ機能を構成します。
- アドオン トリガー、アクション、イベント オブジェクトを使用して Chat インターフェースを構築する方法について説明します。
制限事項と既知の問題
次のチャットおよびアドオン機能は利用できません。
- Chat 用アプリのアーキテクチャである Dialogflow、Pub/Sub、AppSheet は使用できません。代わりに、Apps Script または HTTP サービスを使用して Chat アプリを構築する必要があります。
- Apps Script の カード サービス。チャット用アクションを使用してカードを作成するには、代わりに JSON オブジェクトを返します。例については、ダイアログを開いて応答するとリンクをプレビューするをご覧ください。
- カスタム承認カード。Chat からサービスを認証して認可を付与するには、Chat 用アプリが基本認証カードを返す必要があります。
- Chat サイドバーのアドオン ホームページ。アドオンにホームページ トリガーを設定した場合、ホームページはアドオンによって拡張される他の Google Workspace アプリケーションのサイドバーにのみ表示されます。
- チャット アプリのホームページ。チャット アプリでのダイレクト メッセージの [ホーム] タブに表示されます。
既存の Google Workspace アドオンを更新する場合は、Chat アプリの次の構成要件を考慮してください。
- Google Workspace Marketplace のインストール設定で、個人と Google Workspace 管理者の両方がアドオンをインストールできるようにする必要があります。
- アドオンのマニフェスト(
addons.common)にある共通の構成設定は、Chat では無視されます。アドオンをチャットで動作するように構成するには、チャット API を有効にして構成する必要があります。手順については、Google Chat アプリを設定するをご覧ください。 - Chat でアドオンをデプロイしてテストするには、Chat API の公開設定を使用する必要があります。Google Workspace Marketplace SDK で構成した公開設定やテスト設定はすべて無視されます。Chat でアドオンのテスト版をデプロイするには、Chat API ドキュメントの Google Chat アプリのインタラクティブ機能をテストするをご覧ください。
- アドオンが Google Workspace Marketplace に公開されている場合、Google Chat API 構成設定の変更のドラフトを保存することはできません。Chat API 構成設定を更新すると、更新された Chat アプリが既存のすべてのユーザーにすぐに利用可能になります。マーケットプレイスのリスティングを更新するには、変更を送信する前に下書きを作成できます。
関連トピック
- Google Chat API ドキュメントの概要
- サンプルを試す: