批量更新一个聊天室的成员。
HTTP 请求
POST https://meet.googleapis.com/v2/{parent=spaces/*}/members:batchUpdate
网址采用 gRPC 转码语法。
路径参数
| 参数 | |
|---|---|
parent |
必需。所有要更新的 Member 共享的父级资源。格式:spaces/{space} |
请求正文
请求正文中包含结构如下的数据:
| JSON 表示法 |
|---|
{
"requests": [
{
object ( |
| 字段 | |
|---|---|
requests[] |
必需。指定要更新的资源的请求消息。一个批次最多可以修改 500 位成员。 |
updateMask |
可选。用于指定所有 UpdateMemberRequest 中要更新的成员字段的顶级字段掩码。顶层和子字段掩码有 4 种可能的情况:1. 顶层和子字段掩码均不存在:系统会更新请求中提供的所有字段,包括删除请求中未设置的字段。2. 存在顶级字段掩码,但不存在子级字段掩码:系统会更新顶级字段掩码中指定的字段。3. 存在顶级字段掩码和子级字段掩码:子级字段掩码必须与顶级字段掩码相同。4. 缺少顶级字段掩码,但存在子字段掩码:不支持此情况,系统会返回错误。 |
响应正文
批量更新成员的响应。
如果成功,响应正文将包含结构如下的数据:
| JSON 表示法 |
|---|
{
"members": [
{
object ( |
| 字段 | |
|---|---|
members[] |
会员已更新。 |
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/meetings.space.created
如需了解详情,请参阅授权指南。
UpdateMemberRequest
请求更新成员。
| JSON 表示法 |
|---|
{
"member": {
object ( |
| 字段 | |
|---|---|
member |
必需。要更新的成员。格式:spaces/{space}/members/{member} |
updateMask |
可选。用于指定要更新的成员字段的字段掩码。如果未提供 updateMask(未设置、设置了空路径或仅将 "" 作为路径),则默认更新请求中提供值的所有字段。使用“*”作为 updateMask 将更新所有字段,包括删除请求中未设置的字段。对于 BatchUpdate,如果将 UpdateMemberRequest 构建为 BatchUpdateMembersRequest 的子请求,则该字段必须不存在或与 BatchUpdateMembersRequest 中的 updateMask 相同。 |