Users may be assigned at most one Role per network. Each role provides a
user with permissions to perform specific operations. Without a
role, they will not be able to perform any actions.
Namespace
https://www.google.com/apis/ads/publisher/v202505
Field
UserRecord (inherited)
id
xsd:long
The unique ID of the User. This attribute is readonly and is assigned by Google.
name
xsd:string
The name of the User. It has a maximum length of 128 characters.
email
xsd:string
The email or login of the User. In order to create a new user, you must already have a
Google Account.
roleId
xsd:long
The unique role ID of the User. Roles that are created by Google will have negative
IDs.
roleName
xsd:string
The name of the role assigned to the User. This attribute is readonly.
User
isActive
xsd:boolean
Specifies whether or not the User is active. An inactive user cannot log in to the
system or perform any operations. This attribute is read-only.
externalId
xsd:string
An identifier for the User that is meaningful to the publisher. This attribute is
optional and has a maximum length of 255 characters.
isServiceAccount
xsd:boolean
Whether the user is an OAuth2 service account user. This attribute is read-only. Service
account users can only be added through the UI.
ordersUiLocalTimeZoneId
xsd:string
The long format timezone id (e.g. "America/Los_Angeles") used in
the orders and line items UI for this User. Set this to null to indicate that no such value is defined
for the User - UI then defaults
to using the Network's timezone.
This setting only affects the UI for this user and does not in
particular affect the timezone of any dates and times returned in
API responses.
[[["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-08-06 UTC."],[],[],null,["# type User (v202505)\n\n**Service** \n**UserService** **Dependencies** \n[UserPage](/ad-manager/api/reference/v202505/UserService.UserPage) [createUsers()](/ad-manager/api/reference/v202505/UserService#createUsers) [getCurrentUser()](/ad-manager/api/reference/v202505/UserService#getCurrentUser) [updateUsers()](/ad-manager/api/reference/v202505/UserService#updateUsers) \n▼\n**User** **Inheritance** \n[UserRecord](/ad-manager/api/reference/v202505/UserService.UserRecord) \n▼\n**User**\n\n\nRepresents a user of the system.\n\nUsers may be assigned at most one [Role](/ad-manager/api/reference/v202505/UserService.Role) per network. Each role provides a\nuser with permissions to perform specific operations. Without a\nrole, they will not be able to perform any actions.\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202505`\n\n| Field ----- ||\n|-------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **`UserRecord` (inherited)** ||\n| ### `id` | ` `xsd:`long` The unique ID of the `User`. This attribute is readonly and is assigned by Google. |\n| ### `name` | ` `xsd:`string` The name of the `User`. It has a maximum length of 128 characters. |\n| ### `email` | ` `xsd:`string` The email or login of the `User`. In order to create a new user, you must already have a [Google Account](https://www.google.com/accounts/ManageAccount). |\n| ### `roleId` | ` `xsd:`long` The unique role ID of the `User`. Roles that are created by Google will have negative IDs. |\n| ### `roleName` | ` `xsd:`string` The name of the role assigned to the `User`. This attribute is readonly. |\n| **`User`** ||\n| ### `isActive` | ` `xsd:`boolean` Specifies whether or not the `User` is active. An inactive user cannot log in to the system or perform any operations. This attribute is read-only. |\n| ### `externalId` | ` `xsd:`string` An identifier for the `User` that is meaningful to the publisher. This attribute is optional and has a maximum length of 255 characters. |\n| ### `isServiceAccount` | ` `xsd:`boolean` Whether the user is an OAuth2 service account user. This attribute is read-only. Service account users can only be added through the UI. |\n| ### `ordersUiLocalTimeZoneId` | ` `xsd:`string` The long format timezone id (e.g. \"America/Los_Angeles\") used in the orders and line items UI for this `User`. Set this to `null` to indicate that no such value is defined for the `User` - UI then defaults to using the Network's timezone. This setting only affects the UI for this user and does not in particular affect the timezone of any dates and times returned in API responses. \u003cbr /\u003e |"]]
