为通话 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 |
必需。要为其创建会员资格的空间的资源名称。 格式:spaces/{space} |
查询参数
参数 | |
---|---|
useAdminAccess |
可选。如果值为 调用用户必须是拥有“管理聊天和聊天室对话”权限的 Google Workspace 管理员。 需要 使用管理员访问权限不支持创建应用会员资格或为管理员的 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
如需了解详情,请参阅授权指南。