- [Resource: UserRole](https://developers.google.com/doubleclick-advertisers/rest/v5/userRoles#UserRole)
  - [JSON representation](https://developers.google.com/doubleclick-advertisers/rest/v5/userRoles#UserRole.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/doubleclick-advertisers/rest/v5/userRoles#METHODS_SUMMARY)

## Resource: UserRole

Contains properties of a[user role](https://support.google.com/dcm/answer/6098287), which is used to manage user access.

| JSON representation |
|---|
| ``` { "id": string, "name": string, "accountId": string, "subaccountId": string, "parentUserRoleId": string, "permissions": [ { object (`https://developers.google.com/doubleclick-advertisers/rest/v5/userRolePermissions#UserRolePermission`) } ], "defaultUserRole": boolean, "kind": string } ``` |

| Fields ||
|---|---|
| `id` | `string (https://developers.google.com/discovery/v1/type-format format)` ID of this user role. This is a read-only, auto-generated field. |
| `name` | `string` Name of this user role. This is a required field. Must be less than 256 characters long. If this user role is under a subaccount, the name must be unique among sites of the same subaccount. Otherwise, this user role is a top-level user role, and the name must be unique among top-level user roles of the same account. |
| `accountId` | `string (https://developers.google.com/discovery/v1/type-format format)` Account ID of this user role. This is a read-only field that can be left blank. |
| `subaccountId` | `string (https://developers.google.com/discovery/v1/type-format format)` Subaccount ID of this user role. This is a read-only field that can be left blank. |
| `parentUserRoleId` | `string (https://developers.google.com/discovery/v1/type-format format)` ID of the user role that this user role is based on or copied from. This is a required field. |
| `permissions[]` | ``object (`https://developers.google.com/doubleclick-advertisers/rest/v5/userRolePermissions#UserRolePermission`)`` userRoles.list of permissions associated with this user role. |
| `defaultUserRole` | `boolean` Whether this is a default user role. Default user roles are created by the system for the account/subaccount and cannot be modified or deleted. Each default user role comes with a basic set of preassigned permissions. |
| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `"dfareporting#userRole"`. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/doubleclick-advertisers/rest/v5/userRoles/delete` | Deletes an existing user role. |
| ### `https://developers.google.com/doubleclick-advertisers/rest/v5/userRoles/get` | Gets one user role by ID. |
| ### `https://developers.google.com/doubleclick-advertisers/rest/v5/userRoles/insert` | Inserts a new user role. |
| ### `https://developers.google.com/doubleclick-advertisers/rest/v5/userRoles/list` | Retrieves a list of user roles, possibly filtered. |
| ### `https://developers.google.com/doubleclick-advertisers/rest/v5/userRoles/patch` | Updates an existing user role. |
| ### `https://developers.google.com/doubleclick-advertisers/rest/v5/userRoles/update` | Updates an existing user role. |