为发起调用的应用创建人工成员资格或应用成员资格。不支持为其他应用创建成员资格。如需查看示例,请参阅 创建成员资格。创建成员资格时,如果指定成员停用了自动接受政策,则系统会邀请他们并接受邀请后才能加入聊天室。否则,创建成员时,系统会将成员直接添加到指定聊天室。需要用户身份验证。
如需指定要添加的成员,请在 CreateMembershipRequest
中设置 membership.member.name
:
如需将发起通话的应用添加到聊天室或两位用户之间的私信,请使用
users/app
。无法将其他应用添加到聊天室。如需添加真人用户,请使用
users/{user}
,其中{user}
可以是用户的电子邮件地址。对于同一 Workspace 组织中的用户,{user}
也可能是 People API 中用户的{person_id}
,或 Directory API 中用户的id
。例如,如果user@example.com
的 People API 人员resourceName
为people/123456789
,您可以通过将membership.member.name
设置为users/user@example.com
或users/123456789
,将用户添加到聊天室。
HTTP 请求
POST https://chat.googleapis.com/v1/{parent=spaces/*}/members
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
parent |
必需。要为其创建成员资格的聊天室的资源名称。 格式:空格/{空格} |
请求正文
请求正文包含一个 Membership
实例。
响应正文
如果成功,响应正文将包含一个新创建的 Membership
实例。
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
如需了解详情,请参阅授权指南。