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