本頁將概述如何建構可擴充 Google Chat 的 Google Workspace 外掛程式。
擴充 Chat 功能的 Google Workspace 外掛程式可協助使用者執行下列操作：
- 預覽 Chat 訊息中的連結，直接在對話中採取行動。
- 在各種 Google Workspace 應用程式中自動或手動執行工作。
- 接收外部工具或服務的快訊/通知。
Google Workspace 外掛程式在 Chat 中的工作原理
在 Chat 中，外掛程式會顯示為 Google Chat 應用程式。如要與使用者互動，Chat 應用程式可以執行下列操作：
- 發送包含文字、卡片和互動式 UI 元素的訊息。
- 回應快速指令。
- 回應 slash 指令。
- 開啟 對話框，幫助使用者完成多步驟流程，例如填寫表單資料。
- 在訊息中預覽連結，並附上實用資訊卡，讓使用者直接在對話中採取行動。
開始使用
如要開始建構可在 Chat 中運作的 Google Workspace 外掛程式，請參閱下列說明文件：
- 嘗試使用 Google Apps Script 或 HTTP 服務 建立一個基本的聊天應用程式的快速入門指南。
- 配置聊天應用以及使用聊天 API 實現的互動功能。
- 瞭解如何使用外掛程式觸發條件、動作和事件物件，建構即時通訊介面。
限制與已知問題
以下聊天功能和附加功能無法使用：
- Chat 應用架構 Dialogflow、Pub/Sub 和 AppSheet 不可用。相反，您必須使用 Apps Script 或 HTTP 服務來建立聊天應用程式。
- Apps Script 的資訊卡服務。如要使用即時通訊動作並建構資訊卡，請改為傳回 JSON 物件。如需相關範例，請參閱「開啟互動式對話方塊」和「預覽連結」。
- 自訂授權卡。如要從 Chat 驗證服務並授予授權，Chat 應用程式必須傳回基本授權資訊卡。
- 外掛程式首頁 位於 Chat 側欄。如果您已為您的外掛程式設定了 主頁觸發器，則主頁僅會顯示在您的外掛程式所擴充的其他 Google Workspace 應用程式的側邊欄中。
- 聊天應用程式首頁，出現在聊天應用程式的直接訊息的首頁標籤中。
如要更新現有的 Google Workspace 外掛程式，請考量 Chat 應用程式的下列設定需求：
- Google Workspace Marketplace 安裝設定 必須允許個人使用者和 Google Workspace 管理員安裝該外掛程式。
- Chat 會忽略外掛程式資訊清單 (
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 商品信息，您可以在提交任何更改之前建立草稿。