为通话应用创建人类成员资格或应用成员资格。不支持为其他应用创建成员资格。如需查看示例,请参阅在聊天室中邀请或添加用户或 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 |
必需。要为其创建成员资格的聊天室的资源名称。 格式:空格/{space} |
查询参数
参数 | |
---|---|
useAdminAccess |
true 时,该方法会使用用户的 Google Workspace 管理员权限运行。发起调用的用户必须是拥有“管理聊天和聊天室对话”权限的 Google Workspace 管理员。 需要 管理员无法通过管理员访问权限为管理员的 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
有关详情,请参阅授权指南。