Method: spaces.members.create

为通话 Chat 应用、用户或 Google 群组创建会员资格。不支持为其他聊天应用创建会员资格。创建会员时，如果指定会员关闭了自动接受政策，则系统会向其发送邀请，并且该会员必须接受聊天室邀请才能加入。否则，创建会员资格会将相应成员直接添加到指定空间。

支持以下类型的身份验证：

  • 应用身份验证（需经管理员批准）和授权范围：

    • 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

应用身份验证不支持以下使用情形：

  • 邀请 Workspace 组织（聊天室所属组织）外部的用户。
  • 向聊天室添加 Google 群组。
  • 将 Chat 应用添加到聊天室。

如需查看使用示例，请参阅：

HTTP 请求

POST https://chat.googleapis.com/v1/{parent=spaces/*}/members

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。要为其创建会员资格的空间的资源名称。

格式：spaces/{space}

查询参数

参数
useAdminAccess

boolean

可选。如果值为 true，则该方法会使用用户的 Google Workspace 管理员权限运行。

调用用户必须是拥有“管理聊天和聊天室对话”权限的 Google Workspace 管理员。

需要 chat.admin.memberships OAuth 2.0 范围。

使用管理员访问权限不支持创建应用会员资格或为管理员的 Google Workspace 组织之外的用户创建会员资格。

请求正文

请求正文包含一个 Membership 实例。

响应正文

如果成功，响应正文将包含一个新创建的 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

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