REST Resource: accounts

  • The Account resource provides information about a Comparison Shopping Service (CSS) or Merchant Center (MC) account, including details like name, type, and parent.

  • AccountType defines the specific type of account, such as CSS group, CSS domain, or various MC account types.

  • Several methods are available to manage accounts: get retrieves account details, listChildAccounts lists sub-accounts, and updateLabels modifies account labels.

  • Accounts can be identified by their name field, which follows the format "accounts/{account}", and they may have manually or automatically assigned labels.

Resource: Account

Information about CSS/MC account.

JSON representation 
{
  "name": string,
  "fullName": string,
  "labelIds": [
    string
  ],
  "automaticLabelIds": [
    string
  ],
  "accountType": enum (AccountType),
  "displayName": string,
  "homepageUri": string,
  "parent": string
}
Fields
name

string

The label resource name. Format: accounts/{account}
fullName

string

Output only. Immutable. The CSS/MC account's full name.
labelIds[]

string (int64 format)

Manually created label IDs assigned to the CSS/MC account by a CSS parent account.
automaticLabelIds[]

string (int64 format)

Automatically created label IDs assigned to the MC account by CSS Center.
accountType

enum (AccountType)

Output only. The type of this account.
displayName

string

The CSS/MC account's short display name.
homepageUri

string

Output only. Immutable. The CSS/MC account's homepage.
parent

string

The CSS/MC account's parent resource. CSS group for CSS domains; CSS domain for MC accounts. Returned only if the user has access to the parent account. Note: For MC sub-accounts, this is also the CSS domain that is the parent resource of the MCA account, since we are effectively flattening the hierarchy."

AccountType

The account type.

Enums
ACCOUNT_TYPE_UNSPECIFIED Unknown account type.
CSS_GROUP CSS group account.
CSS_DOMAIN CSS domain account.
MC_PRIMARY_CSS_MCA MC Primary CSS MCA account.
MC_CSS_MCA MC CSS MCA account.
MC_MARKETPLACE_MCA MC Marketplace MCA account.
MC_OTHER_MCA MC Other MCA account.
MC_STANDALONE MC Standalone account.
MC_MCA_SUBACCOUNT MC MCA sub-account.

Methods

get

 Retrieves a single CSS/MC account by ID.

listChildAccounts

 Lists all the accounts under the specified CSS account ID, and optionally filters by label ID and account name.

updateLabels

 Updates labels assigned to CSS/MC accounts by a CSS domain.