本頁面將概略說明如何建構可擴充 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 API 設定 Chat 應用程式及其互動功能。
- 瞭解如何使用外掛觸發條件、動作和事件物件建構即時通訊介面。
限制與已知問題
以下即時通訊和外掛功能無法使用：
- Dialogflow 和 Pub/Sub。您必須使用 Apps Script 或 HTTP 服務，建立可擴充 Chat 的外掛程式。
- Apps Script 的 Card Service。如要使用聊天動作並建構資訊卡，請改為傳回 JSON 物件。如需相關範例，請參閱「開啟互動式對話方塊」和「預覽連結」。
- 自訂授權資訊卡。如要透過 Chat 驗證並授予服務授權，Chat 應用程式必須傳回基本授權卡片。
- 在 Chat 側欄中，外掛程式首頁。如果您已為外掛程式設定首頁觸發事件，則首頁只會顯示在外掛程式擴充的其他 Google Workspace 應用程式側欄中。
- Chat 應用程式首頁：會顯示在 Chat 應用程式即時訊息的「首頁」分頁中。
如果你要更新現有的 Google Workspace 外掛程式，請考量 Chat 應用程式的下列設定要求：
- Google Workspace Marketplace 安裝設定必須允許個人和 Google Workspace 管理員安裝外掛程式。
- Chat 會忽略外掛程式的資訊清單 (
addons.common) 中任何常見的設定。如要設定外掛程式在 Chat 中運作，您必須啟用並設定 Chat API。如需步驟，請參閱「設定 Google Chat 應用程式」。 - 如果您使用 HTTP 服務進行建構，必須啟用 Google Workspace add-ons API。REST 資源
deployment和project僅適用於其他 Google Workspace 應用程式中的外掛程式部署作業。 - 如要在 Chat 中部署及測試外掛程式，您必須使用 Chat API 的「可見度」設定。系統會忽略您在 Google Workspace Marketplace SDK 中設定的任何顯示或測試設定。如要在 Chat 中部署外掛程式的測試版本，請參閱 Chat API 說明文件中的「測試 Google Chat 應用程式的互動功能」。
- 如果外掛程式已發布至 Google Workspace Marketplace，您就無法儲存 Google Chat API 設定的任何變更草稿。更新 Chat API 設定後，所有現有使用者都能立即使用更新版 Chat 應用程式。如要更新 Marketplace 產品資訊，您可以在提交任何變更之前建立草稿。