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

如要删除聊天室管理员的成员资格，请求者必须是聊天室管理员。如果您使用的是应用身份验证，则应用必须是聊天室创建者。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
name

string

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

删除用户会员资格时，需要使用 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

可选。如果为 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

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