進階 Chat 服務可讓您在 Apps Script 中使用 Google Chat API。這個 API 可讓指令碼尋找、建立及修改 Chat 聊天室、新增或移除聊天室成員,以及讀取或發布含有文字、資訊卡、附件和回應的訊息。
必備條件
- 在 Google Cloud 控制台的 Chat API 設定頁面中設定的 Apps Script Google Chat 應用程式。應用程式的 Apps Script 專案必須使用標準 Google Cloud 專案,而非系統自動為 Apps Script 專案建立的預設專案。如要建立相容的 Google Chat 應用程式,請參閱「使用 Apps Script 建構 Google Chat 應用程式」。
- Chat 應用程式設定驗證功能。代表使用者執行動作需要使用者驗證。以 Chat 應用程式的形式執行動作時,必須使用服務帳戶驗證應用程式。如要查看 Chat API 方法支援的驗證形式,請參閱「Google Chat API 呼叫的必要驗證類型」。
參考資料
如要進一步瞭解這項服務,請參閱 Chat API 參考說明文件。Chat 服務與 Apps Script 中的所有進階服務一樣,會使用與公用 API 相同的物件、方法和參數。
程式碼範例
這些範例說明如何使用進階服務執行常見的 Google Chat API 動作。
張貼含有使用者憑證的訊息
以下範例說明如何代表使用者將訊息發布至 Chat 聊天室。
將
chat.messages.create
授權範圍新增至 Apps Script 專案的appsscript.json
檔案:"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages.create" ]
將以下函式新增至 Apps Script 專案的程式碼:
張貼含有應用程式憑證的訊息
以下範例說明如何代表應用程式將訊息發布至 Chat 聊天室。透過服務帳戶使用進階 Chat 服務,不需要在 appsscript.json
中指定授權範圍。如要進一步瞭解如何透過服務帳戶進行驗證,請參閱以 Google Chat 應用程式進行驗證。
取得聊天室
以下範例說明如何取得 Chat 聊天室的相關資訊。
將
chat.spaces.readonly
授權範圍新增至 Apps Script 專案的appsscript.json
檔案:"oauthScopes": [ "https://www.googleapis.com/auth/chat.spaces.readonly" ]
將以下函式新增至 Apps Script 專案的程式碼:
建立聊天室
以下範例說明如何建立 Chat 聊天室。
將
chat.spaces.create
授權範圍新增至 Apps Script 專案的appsscript.json
檔案:"oauthScopes": [ "https://www.googleapis.com/auth/chat.spaces.create" ]
將以下函式新增至 Apps Script 專案的程式碼:
列出成員資格
以下範例說明如何列出 Chat 聊天室的所有成員。
將
chat.memberships.readonly
授權範圍新增至 Apps Script 專案的appsscript.json
檔案:"oauthScopes": [ "https://www.googleapis.com/auth/chat.memberships.readonly" ]
將以下函式新增至 Apps Script 專案的程式碼:
疑難排解
如果 Error 400: invalid_scope
顯示錯誤訊息 Some requested scopes cannot be shown
,表示您並未在 Apps Script 專案的 appsscript.json
檔案中指定任何授權範圍。在大多數情況下,Apps Script 會自動判斷指令碼所需的範圍,但當您使用 Chat 進階服務時,必須手動將指令碼使用的授權範圍新增至 Apps Script 專案的資訊清單檔案。請參閱設定明確範圍一節。
如要解決這個錯誤,請將適當的授權範圍新增至 Apps Script 專案的 appsscript.json
檔案,做為 oauthScopes
陣列的一部分。舉例來說,如要呼叫 spaces.messages.create
方法,請新增以下內容:
"oauthScopes": [
"https://www.googleapis.com/auth/chat.messages.create"
]
限制和注意事項
進階 Chat 服務不支援以下功能:
- Chat API 方法
media.download
。 - 開發人員預覽版提供的 Chat API 方法
如要下載訊息附件或呼叫開發人員預覽方法,請改用 UrlFetchApp
。