Method: spaces.members.delete

删除成员资格。如需查看示例,请参阅从聊天室中移除用户或 Google Chat 应用

需要用户身份验证

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。要删除的成员资格的资源名称。聊天应用可以删除真人用户或其自己的成员资格。Chat 应用无法删除其他应用的成员资格。

删除人类成员资格时,需要 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

有关详情,请参阅授权指南