Method: labels.revisions.permissions.batchUpdate
更新标签权限。如果指定主账号不存在权限,系统会创建新的标签权限,否则会更新现有权限。权限会影响整个标签资源,不会修改,也不需要发布。
HTTP 请求
POST https://drivelabels.googleapis.com/v2beta/{parent=labels/*/revisions/*}/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-09-04。
[null,null,["最后更新时间 (UTC):2024-09-04。"],[[["Updates permissions for a Drive 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 do not need publishing."],["The API request requires specifying the parent Label resource and providing an array of update requests."],["You can use admin credentials for the update by setting the `useAdminAccess` field to true."],["Successful responses return a `BatchUpdateLabelPermissionsResponse` object."]]],["This outlines the process for updating Label permissions via a `POST` request to `https://drivelabels.googleapis.com/v2beta/{parent=labels/*/revisions/*}/permissions:batchUpdate`. The request requires a `parent` path parameter specifying the Label resource. The request body uses JSON, containing an array of `UpdateLabelPermissionRequest` objects and an optional `useAdminAccess` boolean. Successful requests return a `BatchUpdateLabelPermissionsResponse`. The operation requires specific OAuth scopes and admin privileges if the `useAdminAccess` field is true.\n"]]