Method: labels.revisions.permissions.batchUpdate

Updates 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.

HTTP request

POST https://drivelabels.googleapis.com/v2/{parent=labels/*/revisions/*}/permissions:batchUpdate

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
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.

Request body

The request body contains data with the following structure:

JSON representation
{
  "requests": [
    {
      object (UpdateLabelPermissionRequest)
    }
  ],
  "useAdminAccess": boolean
}
Fields
requests[]

object (UpdateLabelPermissionRequest)

Required. The request message specifying the resources to update.

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.

Response body

If successful, the response body contains an instance of BatchUpdateLabelPermissionsResponse.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

For more information, see the Authorization guide.