Method: spaces.delete

刪除已命名的聊天室。系統一律會執行連鎖刪除作業，也就是說，聊天室的子項資源 (例如在聊天室中發布的訊息和聊天室成員資格) 也會一併刪除。如需範例，請參閱「刪除聊天室」。

支援下列類型的驗證：

  • 在開發人員預覽版中，使用管理員核准的應用程式驗證和授權範圍：

    • https://www.googleapis.com/auth/chat.app.delete (僅限應用程式建立的聊天室)

  • 使用下列其中一個授權範圍進行使用者驗證：

    • https://www.googleapis.com/auth/chat.delete
    • https://www.googleapis.com/auth/chat.import (僅限匯入模式聊天室)
    • 當管理員帳戶進行驗證、useAdminAccess 為 true，且使用下列授權範圍時，使用者驗證會授予管理員權限：
      • https://www.googleapis.com/auth/chat.admin.delete

HTTP 要求

DELETE https://chat.googleapis.com/v1/{name=spaces/*}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

必要欄位。要刪除的聊天室資源名稱。

格式：spaces/{space}

查詢參數

參數
useAdminAccess

boolean

(非必要) 當 true 時，方法會使用使用者的 Google Workspace 管理員權限執行。

撥打電話的使用者必須是具備「管理即時通訊和聊天室對話」權限的 Google Workspace 管理員。

需要 chat.admin.delete OAuth 2.0 範圍。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體會是空白的 JSON 物件。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/chat.app.delete
  • https://www.googleapis.com/auth/chat.admin.delete
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.delete

詳情請參閱授權指南。