REST Resource: roles
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ressource: Rolle
| JSON-Darstellung |
{
"roleId": string,
"roleName": string,
"roleDescription": string,
"rolePrivileges": [
{
"serviceId": string,
"privilegeName": string
}
],
"isSystemRole": boolean,
"isSuperAdminRole": boolean,
"kind": string,
"etag": string
} |
| Felder |
roleId |
string (int64 format)
ID der Rolle.
|
roleName |
string
Name der Rolle.
|
roleDescription |
string
Eine kurze Beschreibung der Rolle.
|
rolePrivileges[] |
object
Die Berechtigungen, die dieser Rolle gewährt werden.
|
rolePrivileges[].serviceId |
string
Die verschleierte ID des Dienstes, für den dieses Berechtigungsobjekt gilt. Dieser Wert wird mit Privileges.list() zurückgegeben.
|
rolePrivileges[].privilegeName |
string
Der Name des Berechtigungstyps.
|
isSystemRole |
boolean
Gibt true zurück, wenn es sich um eine vordefinierte Systemrolle handelt.
|
isSuperAdminRole |
boolean
Gibt true zurück, wenn es sich um eine Super Admin-Rolle handelt.
|
kind |
string
Der Typ der API-Ressource. Dies ist immer admin#directory#role.
|
etag |
string
ETag der Ressource.
|
Methoden |
|
|
Löscht eine Rolle. |
|
|
Ruft eine Rolle ab. |
|
|
Erstellt eine Rolle. |
|
|
Ruft eine paginaierte Liste aller Rollen in einer Domain ab. |
|
|
Eine Rolle wird gepatcht. |
|
|
Aktualisiert eine Rolle. |
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-24 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-24 (UTC)."],[],[],null,["# REST Resource: roles\n\nResource: Role\n--------------\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"roleId\": string, \"roleName\": string, \"roleDescription\": string, \"rolePrivileges\": [ { \"serviceId\": string, \"privilegeName\": string } ], \"isSystemRole\": boolean, \"isSuperAdminRole\": boolean, \"kind\": string, \"etag\": string } ``` |\n\n| Fields ||\n|----------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `roleId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` ID of the role. |\n| `roleName` | `string` Name of the role. |\n| `roleDescription` | `string` A short description of the role. |\n| `rolePrivileges[]` | `object` The set of privileges that are granted to this role. |\n| `rolePrivileges[].serviceId` | `string` The obfuscated ID of the service this privilege is for. This value is returned with [`Privileges.list()`](https://developers.google.com/workspace/admin/directory/v1/reference/privileges/list). |\n| `rolePrivileges[].privilegeName` | `string` The name of the privilege. |\n| `isSystemRole` | `boolean` Returns `true` if this is a pre-defined system role. |\n| `isSuperAdminRole` | `boolean` Returns `true` if the role is a super admin role. |\n| `kind` | `string` The type of the API resource. This is always `admin#directory#role`. |\n| `etag` | `string` ETag of the resource. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------|----------------------------------------------------------|\n| ### [delete](/workspace/admin/directory/reference/rest/v1/roles/delete) | Deletes a role. |\n| ### [get](/workspace/admin/directory/reference/rest/v1/roles/get) | Retrieves a role. |\n| ### [insert](/workspace/admin/directory/reference/rest/v1/roles/insert) | Creates a role. |\n| ### [list](/workspace/admin/directory/reference/rest/v1/roles/list) | Retrieves a paginated list of all the roles in a domain. |\n| ### [patch](/workspace/admin/directory/reference/rest/v1/roles/patch) | Patches a role. |\n| ### [update](/workspace/admin/directory/reference/rest/v1/roles/update) | Updates a role. |"]]
