Method: roles.insert
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
HTTP-Anfrage
POST https://admin.googleapis.com/admin/directory/v1/customer/{customer}/roles
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
customer |
string
Die unveränderliche ID des Google Workspace-Kontos.
|
Anfragetext
Der Anfragetext enthält eine Instanz von Role.
Antworttext
Bei Erfolg enthält der Antworttext eine neu erstellte Instanz von Role.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/admin.directory.rolemanagement
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
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-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (UTC)."],[],[],null,["# Method: roles.insert\n\nCreates a role.\n\n### HTTP request\n\n`POST https://admin.googleapis.com/admin/directory/v1/customer/{customer}/roles`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|--------------------------------------------------------|\n| `customer` | `string` Immutable ID of the Google Workspace account. |\n\n### Request body\n\nThe request body contains an instance of [Role](/workspace/admin/directory/reference/rest/v1/roles#Role).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Role](/workspace/admin/directory/reference/rest/v1/roles#Role).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/admin.directory.rolemanagement`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
