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