Required. The name of the User. It has a maximum length of 128 characters.
email
string
Required. The email or login of the User. In order to create a new user, you must already have a Google Account.
role
string
Required. The unique Role ID of the User. Roles that are created by Google will have negative IDs.
active
boolean
Output only. Specifies whether or not the User is active. An inactive user cannot log in to the system or perform any operations.
externalId
string
Optional. An identifier for the User that is meaningful to the publisher. This attribute has a maximum length of 255 characters.
serviceAccount
boolean
Output only. Whether the user is an OAuth2 service account user. Service account users can only be added through the UI.
ordersUiLocalTimeZone
string
Optional. The IANA Time Zone Database time zone, e.g. "America/New_York", used in the orders and line items UI for this User. If not provided, the UI then defaults to using the Network's timezone. This setting only affects the UI for this user and does not 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-20 UTC."],[[["\u003cp\u003eThe User resource represents a user within the system, containing details like name, ID, email, role, and activity status.\u003c/p\u003e\n"],["\u003cp\u003eUsers can be identified by a unique \u003ccode\u003euserId\u003c/code\u003e and must have a Google Account to be created.\u003c/p\u003e\n"],["\u003cp\u003eA user's role is determined by a unique Role ID, with Google-created roles possessing negative IDs.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides a method to retrieve individual user details using the \u003ccode\u003eget\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eUser activity status determines their system access and operational capabilities.\u003c/p\u003e\n"]]],["The provided content defines the \"User\" resource, detailing its JSON representation and fields. Key information includes the `name`, `userId`, `displayName`, `email`, and `role`, with `active` and `serviceAccount` fields indicating user status. Optional fields like `externalId` and `ordersUiLocalTimeZone` provide additional details. The `get` method is available to retrieve User objects, allowing you to retrieve an existing user. The resource describes a user format.\n"],null,["# REST Resource: networks.users\n\n- [Resource: User](#User)\n - [JSON representation](#User.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: User\n--------------\n\nThe User resource.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"userId\": string, \"displayName\": string, \"email\": string, \"role\": string, \"active\": boolean, \"externalId\": string, \"serviceAccount\": boolean, \"ordersUiLocalTimeZone\": string } ``` |\n\n| Fields ||\n|-------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Identifier. The resource name of the User. Format: `networks/{networkCode}/users/{userId}` |\n| `userId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. `User` ID. |\n| `displayName` | `string` Required. The name of the User. It has a maximum length of 128 characters. |\n| `email` | `string` Required. The email or login of the User. In order to create a new user, you must already have a Google Account. |\n| `role` | `string` Required. The unique Role ID of the User. Roles that are created by Google will have negative IDs. |\n| `active` | `boolean` Output only. Specifies whether or not the User is active. An inactive user cannot log in to the system or perform any operations. |\n| `externalId` | `string` Optional. An identifier for the User that is meaningful to the publisher. This attribute has a maximum length of 255 characters. |\n| `serviceAccount` | `boolean` Output only. Whether the user is an OAuth2 service account user. Service account users can only be added through the UI. |\n| `ordersUiLocalTimeZone` | `string` Optional. The IANA Time Zone Database time zone, e.g. \"America/New_York\", used in the orders and line items UI for this User. If not provided, the UI then defaults to using the Network's timezone. This setting only affects the UI for this user and does not affect the timezone of any dates and times returned in API responses. |\n\n| Methods ------- ||\n|----------------------------------------------------------------------|--------------------------------|\n| ### [get](/ad-manager/api/beta/reference/rest/v1/networks.users/get) | API to retrieve a User object. |"]]
