REST Resource: accounts
Stay organized with collections
Save and categorize content based on your preferences.
Resource: Account
Representation of an account.
| JSON representation |
{
"name": string,
"displayName": string,
"premium": boolean,
"timeZone": {
object (TimeZone)
},
"createTime": string,
"pendingTasks": [
string
],
"state": enum (State)
} |
| Fields |
name |
string
Output only. Resource name of the account. Format: accounts/pub-[0-9]+
|
displayName |
string
Output only. Display name of this account.
|
premium |
boolean
Output only. Whether this account is premium. Premium accounts have access to additional spam-related metrics.
|
timeZone |
object (TimeZone)
The account time zone, as used by reporting. For more information, see changing the time zone of your reports.
|
createTime |
string (Timestamp format)
Output only. Creation time of the account. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
|
pendingTasks[] |
string
Output only. Outstanding tasks that need to be completed as part of the sign-up process for a new account. e.g. "billing-profile-creation", "phone-pin-verification".
|
state |
enum (State)
Output only. State of the account.
|
TimeZone
| JSON representation |
{
"id": string,
"version": string
} |
| Fields |
id |
string
IANA Time Zone Database time zone. For example "America/New_York".
|
version |
string
Optional. IANA Time Zone Database version number. For example "2019a".
|
State
Possible states of the account.
| Enums |
STATE_UNSPECIFIED |
State unspecified. |
READY |
The account is open and ready to serve ads. |
NEEDS_ATTENTION |
There are some issues with this account. Publishers should visit AdSense in order to fix the account. |
CLOSED |
The account is closed and can't serve ads. |
Methods |
|
|
Gets information about the selected AdSense account. |
|
|
Gets the ad blocking recovery tag of an account. |
|
|
Lists all accounts available to this user. |
|
|
Lists all accounts directly managed by the given AdSense account. |
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-06-23 UTC.
[null,null,["Last updated 2025-06-23 UTC."],[[["\u003cp\u003eThis documentation details the 'Account' resource in AdSense, including its properties like name, display name, time zone, and state.\u003c/p\u003e\n"],["\u003cp\u003eIt outlines the structure and fields of 'Account' and 'TimeZone' objects represented in JSON format.\u003c/p\u003e\n"],["\u003cp\u003eThe 'State' section describes the various operational states an AdSense account can be in.\u003c/p\u003e\n"],["\u003cp\u003eAvailable methods for interacting with accounts, such as getting account information, ad blocking recovery tags, and listing accounts, are also provided.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can utilize this information to programmatically manage and access AdSense account data.\u003c/p\u003e\n"]]],["The provided content defines the \"Account\" resource, including its JSON representation and fields like `name`, `displayName`, `premium` status, `timeZone`, `createTime`, `pendingTasks`, and `state`. It details the structure of the `TimeZone` object, specifying `id` and `version`. The `State` enum defines account states: `READY`, `NEEDS_ATTENTION`, `CLOSED`, and `STATE_UNSPECIFIED`. Methods are described: `get`, `getAdBlockingRecoveryTag`, `list`, and `listChildAccounts`, enabling actions like retrieving account information and listing accounts.\n"],null,["# REST Resource: accounts\n\n- [Resource: Account](#Account)\n - [JSON representation](#Account.SCHEMA_REPRESENTATION)\n- [TimeZone](#TimeZone)\n - [JSON representation](#TimeZone.SCHEMA_REPRESENTATION)\n- [State](#State)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Account\n-----------------\n\nRepresentation of an account.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"displayName\": string, \"premium\": boolean, \"timeZone\": { object (/adsense/management/reference/rest/v2/accounts#TimeZone) }, \"createTime\": string, \"pendingTasks\": [ string ], \"state\": enum (/adsense/management/reference/rest/v2/accounts#State) } ``` |\n\n| Fields ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. Resource name of the account. Format: accounts/pub-\\[0-9\\]+ |\n| `displayName` | `string` Output only. Display name of this account. |\n| `premium` | `boolean` Output only. Whether this account is premium. Premium accounts have access to additional spam-related metrics. |\n| `timeZone` | `object (`[TimeZone](/adsense/management/reference/rest/v2/accounts#TimeZone)`)` The account time zone, as used by reporting. For more information, see [changing the time zone of your reports](https://support.google.com/adsense/answer/9830725). |\n| `createTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Output only. Creation time of the account. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `pendingTasks[]` | `string` Output only. Outstanding tasks that need to be completed as part of the sign-up process for a new account. e.g. \"billing-profile-creation\", \"phone-pin-verification\". |\n| `state` | `enum (`[State](/adsense/management/reference/rest/v2/accounts#State)`)` Output only. State of the account. |\n\nTimeZone\n--------\n\nRepresents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones).\n\n| JSON representation |\n|---------------------------------------------|\n| ``` { \"id\": string, \"version\": string } ``` |\n\n| Fields ||\n|-----------|---------------------------------------------------------------------------------|\n| `id` | `string` IANA Time Zone Database time zone. For example \"America/New_York\". |\n| `version` | `string` Optional. IANA Time Zone Database version number. For example \"2019a\". |\n\nState\n-----\n\nPossible states of the account.\n\n| Enums ||\n|---------------------|-------------------------------------------------------------------------------------------------------|\n| `STATE_UNSPECIFIED` | State unspecified. |\n| `READY` | The account is open and ready to serve ads. |\n| `NEEDS_ATTENTION` | There are some issues with this account. Publishers should visit AdSense in order to fix the account. |\n| `CLOSED` | The account is closed and can't serve ads. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------|\n| ### [get](/adsense/management/reference/rest/v2/accounts/get) | Gets information about the selected AdSense account. |\n| ### [getAdBlockingRecoveryTag](/adsense/management/reference/rest/v2/accounts/getAdBlockingRecoveryTag) | Gets the ad blocking recovery tag of an account. |\n| ### [list](/adsense/management/reference/rest/v2/accounts/list) | Lists all accounts available to this user. |\n| ### [listChildAccounts](/adsense/management/reference/rest/v2/accounts/listChildAccounts) | Lists all accounts directly managed by the given AdSense account. |"]]
