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