为发起调用的应用创建人类成员资格或应用成员资格。不支持为其他应用创建成员资格。如需查看示例,请参阅向聊天室邀请或添加用户或 Google Chat 应用。创建成员资格时,如果指定成员停用了自动接受政策,他们就会收到邀请,且必须接受聊天室邀请才能加入。否则,创建成员资格后,系统会将成员直接添加到指定的聊天室。要求进行用户身份验证。
如需指定要添加的成员,请为真人或应用成员设置 membership.member.name
,或为群组成员设置 membership.group_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
,以将用户添加到聊天室。如需在命名聊天室中添加或邀请 Google 群组,请使用
groups/{group}
,其中{group}
是 Cloud Identity Groups API 中群组的id
。例如,您可以使用 Cloud Identity Groups lookup API 检索群组电子邮件地址group@example.com
的 ID123456789
,然后将membership.group_member.name
设为groups/123456789
,将群组添加或邀请加入命名聊天室。系统不支持群组电子邮件地址,且 Google 群组只能添加为已命名聊天室的成员。
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
有关详情,请参阅授权指南。