REST Resource: accounts

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

createAndConfigure

Creates a Merchant Center account with additional configuration.

delete

Deletes the specified account regardless of its type: standalone, advanced account or sub-account.

get

Retrieves an account from your Merchant Center account.

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.

listSubaccounts

List all sub-accounts for a given multi client account.

patch

Updates an account regardless of its type: standalone, advanced account or sub-account.