Method: labels.permissions.batchDelete
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Löscht Labelberechtigungen. Berechtigungen wirken sich auf die gesamte Label-Ressource aus, werden nicht versioniert und müssen nicht veröffentlicht werden.
HTTP-Anfrage
POST https://drivelabels.googleapis.com/v2/{parent=labels/*}/permissions:batchDelete
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter |
parent |
string
Erforderlich. Der Name der übergeordneten Labelressource, die von allen Berechtigungen gemeinsam genutzt wird, die gelöscht werden. Format: labels/{label} . Wenn dieser Wert festgelegt ist, muss das übergeordnete Feld in den UpdateLabelPermissionRequest -Nachrichten entweder leer sein oder mit diesem Feld übereinstimmen.
|
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
Felder |
requests[] |
object (DeleteLabelPermissionRequest )
Erforderlich. Die Anfragenachricht, in der die zu aktualisierenden Ressourcen angegeben werden.
|
useAdminAccess |
boolean
Legen Sie true fest, um die Administratoranmeldedaten des Nutzers zu verwenden. Der Server prüft, ob der Nutzer Administrator des Labels ist, bevor er den Zugriff zulässt. Wenn dieses Feld festgelegt ist, muss das Feld useAdminAccess in den DeleteLabelPermissionRequest -Nachrichten entweder leer sein oder mit diesem Feld übereinstimmen.
|
Antworttext
Wenn der Vorgang erfolgreich ist, ist der Antworttext ein leeres JSON-Objekt.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/drive.labels
https://www.googleapis.com/auth/drive.admin.labels
Weitere Informationen finden Sie im Autorisierungsleitfaden.
DeleteLabelPermissionRequest
Löscht eine Labelberechtigung. Berechtigungen wirken sich auf die gesamte Label-Ressource aus, werden nicht versioniert und müssen nicht veröffentlicht werden.
JSON-Darstellung |
{
"name": string,
"useAdminAccess": boolean
} |
Felder |
name |
string
Erforderlich. Ressourcenname der Labelberechtigung.
|
useAdminAccess |
boolean
Legen Sie true fest, um die Administratoranmeldedaten des Nutzers zu verwenden. Der Server prüft, ob der Nutzer Administrator des Labels ist, bevor er den Zugriff zulässt.
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-05 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]