Method: spaces.members.delete

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

必須完成使用者驗證

HTTP 要求

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

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

路徑參數

參數
name

string

必要欄位。要刪除的成員資格資源名稱。即時通訊應用程式可刪除使用者或本身的成員資格。即時通訊應用程式無法刪除其他應用程式的成員。

刪除真人成員時,您必須使用 chat.memberships 範圍和 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

true 時,這個方法會使用使用者的 Google Workspace 管理員權限執行。

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

需要 chat.admin.memberships OAuth 2.0 範圍

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

要求主體

要求主體必須為空白。

回應主體

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

授權範圍

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

  • 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

詳情請參閱授權指南