Method: labels.permissions.batchDelete
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Supprime les autorisations de libellé. Les autorisations affectent la ressource de libellé dans son ensemble, ne sont pas révisées et ne nécessitent pas de publication.
Requête HTTP
POST https://drivelabels.googleapis.com/v2/{parent=labels/*}/permissions:batchDelete
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
parent |
string
Obligatoire. Nom de la ressource de libellé parent partagé par toutes les autorisations supprimées. Format : labels/{label}. Si cette valeur est définie, le champ parent des messages UpdateLabelPermissionRequest doit être vide ou correspondre à ce champ.
|
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
| Champs |
requests[] |
object (DeleteLabelPermissionRequest)
Obligatoire. Message de requête spécifiant les ressources à mettre à jour.
|
useAdminAccess |
boolean
Définissez cette valeur sur true pour utiliser les identifiants d'administrateur de l'utilisateur. Le serveur vérifiera que l'utilisateur est un administrateur du label avant d'autoriser l'accès. Si cette valeur est définie, le champ useAdminAccess des messages DeleteLabelPermissionRequest doit être vide ou correspondre à ce champ.
|
Corps de la réponse
Si la requête aboutit, le corps de la réponse est un objet JSON vide.
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/drive.labels
https://www.googleapis.com/auth/drive.admin.labels
Pour en savoir plus, consultez le guide d'autorisation.
DeleteLabelPermissionRequest
Supprime une autorisation de libellé. Les autorisations affectent la ressource de libellé dans son ensemble, ne sont pas révisées et ne nécessitent pas de publication.
| Représentation JSON |
{
"name": string,
"useAdminAccess": boolean
} |
| Champs |
name |
string
Obligatoire. Nom de ressource de l'autorisation de libellé.
|
useAdminAccess |
boolean
Définissez cette valeur sur true pour utiliser les identifiants d'administrateur de l'utilisateur. Le serveur vérifiera que l'utilisateur est un administrateur du label avant d'autoriser l'accès.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/05 (UTC).
[null,null,["Dernière mise à jour le 2025/08/05 (UTC)."],[],[],null,["# Method: labels.permissions.batchDelete\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- [DeleteLabelPermissionRequest](#DeleteLabelPermissionRequest)\n - [JSON representation](#DeleteLabelPermissionRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nDeletes label permissions. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.\n\n### HTTP request\n\n`POST https://drivelabels.googleapis.com/v2/{parent=labels/*}/permissions:batchDelete`\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 deleted. 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 (/workspace/drive/labels/reference/rest/v2/labels.permissions/batchDelete#DeleteLabelPermissionRequest) } ], \"useAdminAccess\": boolean } ``` |\n\n| Fields ||\n|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (`[DeleteLabelPermissionRequest](/workspace/drive/labels/reference/rest/v2/labels.permissions/batchDelete#DeleteLabelPermissionRequest)`)` 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 `DeleteLabelPermissionRequest` messages must either be empty or match this field. |\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\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).\n\nDeleteLabelPermissionRequest\n----------------------------\n\nDeletes a label permission. Permissions affect the label resource as a whole, aren't revisioned, and don't require publishing.\n\n| JSON representation |\n|-------------------------------------------------------|\n| ``` { \"name\": string, \"useAdminAccess\": boolean } ``` |\n\n| Fields ||\n|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. Label permission resource name. |\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. |"]]
