REST Resource: userRoles
Stay organized with collections
Save and categorize content based on your preferences.
Resource: UserRole
Contains properties of auser role, which is used to manage user access.
JSON representation |
{
"id": string,
"name": string,
"accountId": string,
"subaccountId": string,
"parentUserRoleId": string,
"permissions": [
{
object (UserRolePermission )
}
],
"defaultUserRole": boolean,
"kind": string
} |
Fields |
id |
string (int64 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 (int64 format)
Account ID of this user role. This is a read-only field that can be left blank.
|
subaccountId |
string (int64 format)
Subaccount ID of this user role. This is a read-only field that can be left blank.
|
parentUserRoleId |
string (int64 format)
ID of the user role that this user role is based on or copied from. This is a required field.
|
permissions[] |
object (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 |
|
Deletes an existing user role. |
|
Gets one user role by ID. |
|
Inserts a new user role. |
|
Retrieves a list of user roles, possibly filtered. |
|
Updates an existing user role. |
|
Updates an existing user role. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-02 UTC.
[null,null,["Last updated 2025-09-02 UTC."],[],[],null,["- [Resource: UserRole](#UserRole)\n - [JSON representation](#UserRole.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: UserRole Contains properties of a[user role](https://support.google.com/dcm/answer/6098287), which is used to manage user access.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"name\": string, \"accountId\": string, \"subaccountId\": string, \"parentUserRoleId\": string, \"permissions\": [ { object (/doubleclick-advertisers/rest/v5/userRolePermissions#UserRolePermission) } ], \"defaultUserRole\": boolean, \"kind\": string } ``` |\n\n| Fields ||\n|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` ID of this user role. This is a read-only, auto-generated field. |\n| `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. |\n| `accountId` | `string (`[int64](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. |\n| `subaccountId` | `string (`[int64](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. |\n| `parentUserRoleId` | `string (`[int64](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. |\n| `permissions[]` | `object (`[UserRolePermission](/doubleclick-advertisers/rest/v5/userRolePermissions#UserRolePermission)`)` userRoles.list of permissions associated with this user role. |\n| `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. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"dfareporting#userRole\"` . |\n\n| Methods ||\n|-------------------------------------------------------------|----------------------------------------------------|\n| [delete](/doubleclick-advertisers/rest/v5/userRoles/delete) | Deletes an existing user role. |\n| [get](/doubleclick-advertisers/rest/v5/userRoles/get) | Gets one user role by ID. |\n| [insert](/doubleclick-advertisers/rest/v5/userRoles/insert) | Inserts a new user role. |\n| [list](/doubleclick-advertisers/rest/v5/userRoles/list) | Retrieves a list of user roles, possibly filtered. |\n| [patch](/doubleclick-advertisers/rest/v5/userRoles/patch) | Updates an existing user role. |\n| [update](/doubleclick-advertisers/rest/v5/userRoles/update) | Updates an existing user role. |"]]