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):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[],[],null,["# Method: labels.revisions.permissions.batchUpdate\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates Label permissions. If a permission for the indicated principal doesn't exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.\n\n### HTTP request\n\n`POST https://drivelabels.googleapis.com/v2beta/{parent=labels/*/revisions/*}/permissions:batchUpdate`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent Label resource name shared by all permissions being updated. Format: labels/{label} If this is set, the parent field in the UpdateLabelPermissionRequest messages must either be empty or match this field. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------|\n| ``` { \"requests\": [ { object (`UpdateLabelPermissionRequest`) } ], \"useAdminAccess\": boolean } ``` |\n\n| Fields ||\n|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (``UpdateLabelPermissionRequest``)` Required. The request message specifying the resources to update. |\n| `useAdminAccess` | `boolean` Set to `true` in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access. If this is set, the useAdminAccess field in the UpdateLabelPermissionRequest messages must either be empty or match this field. |\n\n### Response body\n\nIf successful, the response body contains an instance of [BatchUpdateLabelPermissionsResponse](/workspace/drive/labels/reference/rest/v2beta/BatchUpdateLabelPermissionsResponse).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive.labels`\n- `\n https://www.googleapis.com/auth/drive.admin.labels`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]