Method: labels.permissions.batchUpdate
更新标签权限。如果指定主账号不存在权限,系统会创建新的标签权限,否则会更新现有权限。权限会影响整个标签资源,不会修改,也不需要发布。
HTTP 请求
POST https://drivelabels.googleapis.com/v2/{parent=labels/*}/permissions:batchUpdate
网址采用 gRPC 转码语法。
路径参数
参数 |
parent |
string
必需。要更新的所有权限共享的父级标签资源名称。格式:labels/{label} 如果设置此字段,UpdateLabelPermissionRequest 消息中的父字段必须为空或与此字段匹配。
|
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
{
"requests": [
{
object (UpdateLabelPermissionRequest )
}
],
"useAdminAccess": boolean
} |
字段 |
requests[] |
object (UpdateLabelPermissionRequest )
必需。指定要更新的资源的请求消息。
|
useAdminAccess |
boolean
设置为 true 才能使用用户的管理员凭据。服务器会先验证用户是否是该标签的管理员,然后才会允许其访问。如果设置此字段,UpdateLabelPermissionRequest 消息中的 useAdminAccess 字段必须为空或与此字段匹配。
|
授权范围
需要以下 OAuth 范围之一:
https://www.googleapis.com/auth/drive.labels
https://www.googleapis.com/auth/drive.admin.labels
有关详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-10-11。
[null,null,["最后更新时间 (UTC):2024-10-11。"],[[["Updates permissions for a Label, creating new ones if they don't exist and updating existing ones otherwise."],["Permissions apply to the entire Label resource, are not versioned, and don't need publishing."],["The request body should contain an array of `UpdateLabelPermissionRequest` objects and a `useAdminAccess` boolean."],["Requires authorization with either `https://www.googleapis.com/auth/drive.labels` or `https://www.googleapis.com/auth/drive.admin.labels` scopes."],["Successful responses return a `BatchUpdateLabelPermissionsResponse` object."]]],["This content describes updating Label permissions via a `POST` request to `https://drivelabels.googleapis.com/v2/{parent=labels/*}/permissions:batchUpdate`. The `parent` path parameter specifies the Label resource. The request body, in JSON format, includes an array of `UpdateLabelPermissionRequest` objects in `requests` and `useAdminAccess` field that allows using the admin credentials. The response is a `BatchUpdateLabelPermissionsResponse`. This action requires specific OAuth scopes: `drive.labels` or `drive.admin.labels`.\n"]]