本指南說明如何使用 Google Chat API 的 CustomEmoji
資源中的 delete
方法,刪除 Google Workspace 機構中的自訂表情符號。
根據預設,使用者只能刪除自己建立的自訂表情符號。管理員指派的表情符號管理員可以刪除機構中的任何自訂表情符號。
自訂表情符號僅適用於 Google Workspace 帳戶,且管理員必須為貴機構啟用自訂表情符號。詳情請參閱「瞭解 Google Chat 中的自訂表情符號」和「管理自訂表情符號權限」。
必要條件
Node.js
- 具有 Google Chat 存取權的 Business 或 Enterprise 版 Google Workspace 帳戶。
- 設定環境:
- 建立 Google Cloud 專案。
- 設定 OAuth 同意畫面。
- 啟用及設定 Google Chat API,並為 Chat 應用程式命名、設定圖示和說明。
- 安裝 Node.js Cloud 用戶端程式庫。
- 根據您要在 Google Chat API 要求中驗證的方式,建立存取憑證:
- 如要以 Chat 使用者身分進行驗證,請建立 OAuth 用戶端 ID 憑證,並將憑證儲存至本機目錄,命名為
credentials.json
的 JSON 檔案。 - 如要以 Chat 應用程式的身分進行驗證,請建立服務帳戶憑證,然後將憑證儲存為名為
credentials.json
的 JSON 檔案。
- 如要以 Chat 使用者身分進行驗證,請建立 OAuth 用戶端 ID 憑證,並將憑證儲存至本機目錄,命名為
- 根據您要以使用者或 Chat 應用程式的身分驗證,選擇授權範圍。
刪除自訂表情符號
如要使用使用者驗證刪除自訂表情符號,請在要求中傳遞下列項目:
- 指定
chat.customemojis
授權範圍。 - 呼叫
DeleteCustomEmoji()
方法。- 在要求主體中,將
name
設為要刪除的自訂表情符號資源名稱。
- 在要求主體中,將
以下範例會刪除自訂表情符號。
Node.js
如要執行這個範例,請替換下列項目:
EMOJI_NAME
:自訂表情符號的專屬名稱,位於「emoji_name
」欄位。您可以呼叫ListCustomEmoji
方法取得 ID,也可以從使用 Chat API 建立自訂表情符號後,非同步傳回的回應主體中取得 ID。