Method: spaces.members.delete

刪除會員資格。如需範例，請參閱「從聊天室中移除使用者或 Google Chat 應用程式」。

支援下列類型的驗證：

  • 應用程式驗證 (須經管理員核准)，授權範圍如下：

    • https://www.googleapis.com/auth/chat.app.memberships

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

    • https://www.googleapis.com/auth/chat.memberships
    • https://www.googleapis.com/auth/chat.memberships.app (從聊天室中移除通話應用程式)
    • https://www.googleapis.com/auth/chat.import (僅限匯入模式聊天室)
    • 使用者驗證會在管理員帳戶通過驗證時授予管理員權限，useAdminAccess 為 true，且使用下列授權範圍：
      • https://www.googleapis.com/auth/chat.admin.memberships

應用程式驗證不支援下列用途：

  • 從聊天室中移除 Google 網路論壇。
  • 從聊天室中移除 Chat 應用程式。

如要刪除聊天室管理員的成員資格，要求者必須是聊天室管理員。如果使用應用程式驗證，Chat 應用程式必須是聊天室建立者。

HTTP 要求

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

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

路徑參數

參數
name

string

必要欄位。要刪除的會員方案資源名稱，即時通訊應用程式可以刪除人類使用者或自己的成員資格。即時通訊應用程式無法刪除其他應用程式的成員資格。

刪除使用者成員時，需要 chat.memberships 範圍和使用者驗證，或 chat.memberships.app 範圍和應用程式驗證，以及 spaces/{space}/members/{member} 格式。您可以將該電子郵件地址做為 {member} 的別名。舉例來說，spaces/{space}/members/example@gmail.com，其中 example@gmail.com 是 Google Chat 使用者的電子郵件地址。

刪除應用程式成員時，需要 chat.memberships.app 範圍和 spaces/{space}/members/app 格式。

格式：spaces/{space}/members/{member} 或 spaces/{space}/members/app。

查詢參數

參數
useAdminAccess

boolean

(選用步驟) 時，這個方法會使用使用者的 Google Workspace 管理員權限執行。true

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

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

系統不支援使用管理員存取權刪除聊天室中的應用程式成員資格。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體會包含 Membership 的執行例項。

授權範圍

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

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

詳情請參閱授權指南。