REST Resource: accounts

Resource: Account

The Account message represents a merchant'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 multi-client account (MCA) structure. In an MCA 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,
  "adultContent": boolean,
  "testAccount": boolean,
  "timeZone": {
    object (TimeZone)
  },
  "languageCode": string
}
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.
adultContent

boolean

Whether this account contains adult content.
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.
languageCode

string

Required. The account's BCP-47 language code, such as en-US or sr-Latn.

TimeZone

Represents a time zone from the IANA Time Zone Database.

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".

Methods

createAndConfigure

 Creates a standalone Merchant Center account with additional configuration.

delete

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

get

 Retrieves an account from your Merchant Center account.

list

 Lists accounts accessible to the calling user and matching the constraints of the request such as page size or filters.

listSubaccounts

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

patch

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