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.
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
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-02 UTC."],[[["\u003cp\u003eThe UserRole resource manages user access within Display & Video 360 by defining roles and their associated permissions.\u003c/p\u003e\n"],["\u003cp\u003eEach UserRole has properties like ID, name, permissions, and whether it's a default system role.\u003c/p\u003e\n"],["\u003cp\u003eUserRoles can be managed through various methods including creation, deletion, retrieval, and updates.\u003c/p\u003e\n"],["\u003cp\u003eA UserRole is defined by its JSON representation with specific fields like ID, name, account/subaccount IDs, parent role, permissions, default status, and resource kind.\u003c/p\u003e\n"],["\u003cp\u003eYou can use methods such as \u003ccode\u003edelete\u003c/code\u003e, \u003ccode\u003eget\u003c/code\u003e, \u003ccode\u003einsert\u003c/code\u003e, \u003ccode\u003elist\u003c/code\u003e, \u003ccode\u003epatch\u003c/code\u003e, and \u003ccode\u003eupdate\u003c/code\u003e to interact with and manage UserRoles within the system.\u003c/p\u003e\n"]]],[],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/v4/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/v4/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/v4/userRoles/delete) | Deletes an existing user role. |\n| [get](/doubleclick-advertisers/rest/v4/userRoles/get) | Gets one user role by ID. |\n| [insert](/doubleclick-advertisers/rest/v4/userRoles/insert) | Inserts a new user role. |\n| [list](/doubleclick-advertisers/rest/v4/userRoles/list) | Retrieves a list of user roles, possibly filtered. |\n| [patch](/doubleclick-advertisers/rest/v4/userRoles/patch) | Updates an existing user role. |\n| [update](/doubleclick-advertisers/rest/v4/userRoles/update) | Updates an existing user role. |"]]