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.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

如需了解详情，请参阅授权指南。