Method: spaces.members.create

为通话应用创建人类成员资格或应用成员资格。不支持为其他应用创建成员资格。如需查看示例，请参阅在聊天室中邀请或添加用户或 Google Chat 应用。创建成员资格时，如果指定的成员停用了自动接受政策，那么他们就会收到邀请，并且必须接受聊天室邀请才能加入。否则，创建成员资格后，该成员会直接添加到指定的聊天室。需要用户身份验证。

如需指定要添加的成员，请为真人或应用成员设置 membership.member.name。

  • 如需将通话应用添加到两个真人用户之间的聊天室或私信中，请使用 users/app。无法将其他应用添加到聊天室。

  • 如需添加真人用户，请使用 users/{user}，其中 {user} 可以是用户的电子邮件地址。对于同一 Workspace 组织中的用户，{user} 也可以是 People API 中的用户的 id 或 Directory API 中的用户的 id。例如，如果 user@example.com 的 People API 用户个人资料 ID 为 123456789，您可以将 membership.member.name 设置为 users/user@example.com 或 users/123456789，以便将用户添加到聊天室。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。要为其创建成员资格的聊天室的资源名称。

格式：空格/{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.admin.memberships
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.app

有关详情，请参阅授权指南。