Method: labels.permissions.create
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Aktualisiert die Berechtigungen eines Labels. Wenn keine Berechtigung für das angegebene Hauptkonto vorhanden ist, wird eine Labelberechtigung erstellt. Andernfalls wird die vorhandene Berechtigung aktualisiert. 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
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
parent |
string
Erforderlich. Der Ressourcenname des übergeordneten Labels, für das die Labelberechtigung erstellt wird. Format: labels/{label}.
|
Abfrageparameter
| Parameter |
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.
|
Anfragetext
Der Anfragetext enthält eine Instanz von LabelPermission.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von LabelPermission.
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.
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.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates a label's permissions. If a permission for the indicated principal doesn't exist, a label permission is created, otherwise the existing permission is updated. 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`\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 on the label permission is created. Format: `labels/{label}`. |\n\n### Query parameters\n\n| Parameters ||\n|------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|\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. |\n\n### Request body\n\nThe request body contains an instance of [LabelPermission](/workspace/drive/labels/reference/rest/v2/labels.permissions#LabelPermission).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [LabelPermission](/workspace/drive/labels/reference/rest/v2/labels.permissions#LabelPermission).\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)."]]
