REST Resource: accounts
Stay organized with collections
Save and categorize content based on your preferences.
Resource: Account
The Account message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers.
Accounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts.
Establishing an account involves configuring attributes like the account name, time zone, and language preferences.
The Account message is the parent entity for many other resources, for example, AccountRelationship, Homepage, BusinessInfo and so on.
| JSON representation |
{
"name": string,
"accountId": string,
"accountName": string,
"testAccount": boolean,
"timeZone": {
object (TimeZone)
},
"languageCode": string,
"adultContent": boolean
} |
| Fields |
name |
string
Identifier. The resource name of the account. Format: accounts/{account}
|
accountId |
string (int64 format)
Output only. The ID of the account.
|
accountName |
string
Required. A human-readable name of the account. See store name and business name for more information.
|
testAccount |
boolean
Output only. Whether this is a test account.
|
timeZone |
object (TimeZone)
Required. The time zone of the account. On writes, timeZone sets both the reporting_time_zone and the display_time_zone. For reads, timeZone always returns the display_time_zone. If display_time_zone doesn't exist for your account, timeZone is empty. The version field is not supported, won't be set in responses and will be silently ignored if specified in requests.
|
languageCode |
string
Required. The account's BCP-47 language code, such as en-US or sr-Latn.
|
adultContent |
boolean
Optional. Whether this account contains adult content.
|
Methods |
|
|
Creates a Merchant Center account with additional configuration. |
|
|
Deletes the specified account regardless of its type: standalone, advanced account or sub-account. |
|
|
Retrieves an account from your Merchant Center account. |
|
|
Note: For the accounts.list method, quota and limits usage are charged for each user, and not for the Merchant Center ID or the advanced account ID. |
|
|
List all sub-accounts for a given advanced account. |
|
|
Updates an account regardless of its type: standalone, advanced account or sub-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-07-31 UTC.
[null,null,["Last updated 2025-07-31 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eAccount\u003c/code\u003e resource is the central entity in Shopping Ads, managing product data, settings, and interactions with Google and external services.\u003c/p\u003e\n"],["\u003cp\u003eAccounts can be standalone or part of a multi-client account (MCA) structure, where a parent account oversees multiple sub-accounts.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eTimeZone\u003c/code\u003e resource represents a time zone from the IANA Time Zone Database, used to configure account settings.\u003c/p\u003e\n"],["\u003cp\u003eSeveral methods are available for managing accounts, including creating, deleting, retrieving, listing, and updating them.\u003c/p\u003e\n"]]],["The `Account` resource represents a merchant's account in Shopping Ads, managing product data and settings. Accounts can be standalone or part of a Multi-Client Account (MCA). Key actions include creating, deleting, retrieving, and updating accounts. Account attributes include `name`, `accountId`, `accountName`, `timeZone`, and `languageCode`. The `TimeZone` resource specifies the IANA time zone. Methods provided enable actions like listing sub-accounts and create standalone accounts and configuring it.\n"],null,["# REST Resource: accounts\n\n- [Resource: Account](#Account)\n - [JSON representation](#Account.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Account\n-----------------\n\nThe `Account` message represents a business's account within Shopping Ads. It's the primary entity for managing product data, settings, and interactions with Google's services and external providers.\n\nAccounts can operate as standalone entities or be part of a advanced account structure. In an advanced account setup the parent account manages multiple sub-accounts.\n\nEstablishing an account involves configuring attributes like the account name, time zone, and language preferences.\n\nThe `Account` message is the parent entity for many other resources, for example, `AccountRelationship`, `Homepage`, `BusinessInfo` and so on.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"accountId\": string, \"accountName\": string, \"testAccount\": boolean, \"timeZone\": { object (/merchant/api/reference/rest/Shared.Types/DateTime#TimeZone) }, \"languageCode\": string, \"adultContent\": boolean } ``` |\n\n| Fields ||\n|----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Identifier. The resource name of the account. Format: `accounts/{account}` |\n| `accountId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The ID of the account. |\n| `accountName` | `string` Required. A human-readable name of the account. See [store name](https://support.google.com/merchants/answer/160556) and [business name](https://support.google.com/merchants/answer/12159159) for more information. |\n| `testAccount` | `boolean` Output only. Whether this is a test account. |\n| `timeZone` | `object (`[TimeZone](/merchant/api/reference/rest/Shared.Types/DateTime#TimeZone)`)` Required. The time zone of the account. On writes, `timeZone` sets both the `reporting_time_zone` and the `display_time_zone`. For reads, `timeZone` always returns the `display_time_zone`. If `display_time_zone` doesn't exist for your account, `timeZone` is empty. The `version` field is not supported, won't be set in responses and will be silently ignored if specified in requests. |\n| `languageCode` | `string` Required. The account's [BCP-47 language code](https://tools.ietf.org/html/bcp47), such as `en-US` or `sr-Latn`. |\n| `adultContent` | `boolean` Optional. Whether this account contains adult content. |\n\n| Methods ------- ||\n|----------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### [createAndConfigure](/merchant/api/reference/rest/accounts_v1beta/accounts/createAndConfigure) | Creates a Merchant Center account with additional configuration. |\n| ### [delete](/merchant/api/reference/rest/accounts_v1beta/accounts/delete) | Deletes the specified account regardless of its type: standalone, advanced account or sub-account. |\n| ### [get](/merchant/api/reference/rest/accounts_v1beta/accounts/get) | Retrieves an account from your Merchant Center account. |\n| ### [list](/merchant/api/reference/rest/accounts_v1beta/accounts/list) | Note: For the `accounts.list` method, quota and limits usage are charged for each user, and not for the Merchant Center ID or the advanced account ID. |\n| ### [listSubaccounts](/merchant/api/reference/rest/accounts_v1beta/accounts/listSubaccounts) | List all sub-accounts for a given advanced account. |\n| ### [patch](/merchant/api/reference/rest/accounts_v1beta/accounts/patch) | Updates an account regardless of its type: standalone, advanced account or sub-account. |"]]
