本頁面提供總覽,說明如何建構可擴充 Google Chat 的 Google Workspace 外掛程式。
擴充 Chat 功能的 Google Workspace 外掛程式可協助使用者執行下列操作:
- 預覽 Chat 訊息中的連結,並在不離開對話的情況下採取行動。
- 在 Google Workspace 應用程式中自動執行或完成工作。
- 接收外部工具或服務的快訊或通知。
Google Workspace 外掛程式在 Chat 中的運作方式
在 Chat 中,外掛程式會顯示為 Google Chat 應用程式。如要與使用者互動,Chat 應用程式可以執行下列操作:
- 傳送訊息,內含文字、資訊卡和互動式 UI 元素。
- 回應快速指令。
- 回覆斜線指令。
- 開啟對話方塊,協助使用者完成多步驟程序,例如填寫表單資料。
- 在訊息中預覽連結,並附上實用資訊卡,讓使用者直接在對話中採取行動。
開始使用
如要開始建構可在 Google Chat 中使用的 Google Workspace 外掛程式,請參閱下列說明文件:
- 不妨試試快速入門導覽課程,瞭解如何使用 Google Apps Script 或 HTTP 服務建構基本 Chat 擴充應用程式。
- 使用 Chat API 設定 Chat 應用程式及其互動功能。
- 瞭解如何使用外掛程式觸發條件、動作和事件物件,建構即時通訊介面。
限制與已知問題
下列即時通訊和外掛程式功能無法使用:
- Chat 應用程式架構 Dialogflow、 Pub/Sub 和 AppSheet 無法使用。請改用 Apps Script 或 HTTP 服務建構 Chat 應用程式。
- Apps Script 的卡片服務。如要使用即時通訊動作並建構資訊卡,請改為傳回 JSON 物件。如需相關範例,請參閱「開啟互動式對話方塊」和「預覽連結」。
- 自訂授權卡。如要從 Chat 驗證服務並授予授權,Chat 應用程式必須傳回基本授權資訊卡。
- Chat 側欄中的外掛程式首頁。如果已為外掛程式設定首頁觸發條件,首頁只會顯示在外掛程式擴充的其他 Google Workspace 應用程式側欄中。
- Chat 應用程式首頁,會顯示在與 Chat 應用程式的即時訊息首頁分頁中。
如要更新現有的 Google Workspace 外掛程式,請注意 Chat 應用程式的設定需求:
- Google Workspace Marketplace 安裝設定必須允許個人和 Google Workspace 管理員安裝外掛程式。
- 系統會忽略外掛程式資訊清單 (
addons.common
) 中的任何通用設定。如要設定外掛程式在 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 產品資訊,可以先建立草稿,再提交變更。