REST Resource: accounts

Resource: Account

Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, and update require the admin role.

JSON representation
{
  "name": string,
  "kind": string,
  "websiteUrl": string,
  "adultContent": boolean,
  "sellerId": string,
  "users": [
    {
      object (AccountUser)
    }
  ],
  "id": string,
  "youtubeChannelLinks": [
    {
      object (AccountYouTubeChannelLink)
    }
  ],
  "googleMyBusinessLink": {
    object (AccountGoogleMyBusinessLink)
  },
  "businessInformation": {
    object (AccountBusinessInformation)
  },
  "adsLinks": [
    {
      object (AccountAdsLink)
    }
  ],
  "cssId": string,
  "labelIds": [
    string
  ]
}
Fields
name

string

Required. Display name for the account.

kind

string

Identifies what kind of resource this is. Value: the fixed string "content#account"

websiteUrl

string

The merchant's website.

adultContent

boolean

Indicates whether the merchant sells adult content.

sellerId

string

Client-specific, locally-unique, internal ID for the child account.

users[]

object (AccountUser)

Users with access to the account. Every account (except for subaccounts) must have at least one admin user.

id

string

Required for update. Merchant Center account ID.

businessInformation

object (AccountBusinessInformation)

The business information of the account.

cssId

string

ID of CSS the account belongs to.

labelIds[]

string

accounts.list of label IDs that are assigned to the account by CSS.

AccountUser

JSON representation
{
  "emailAddress": string,
  "admin": boolean,
  "orderManager": boolean,
  "paymentsManager": boolean,
  "paymentsAnalyst": boolean
}
Fields
emailAddress

string

User's email address.

admin

boolean

Whether user is an admin.

orderManager

boolean

Whether user is an order manager.

paymentsManager

boolean

Whether user can manage payment settings.

paymentsAnalyst

boolean

Whether user can access payment statements.

AccountBusinessInformation

JSON representation
{
  "address": {
    object (AccountAddress)
  },
  "phoneNumber": string,
  "customerService": {
    object (AccountCustomerService)
  }
}
Fields
address

object (AccountAddress)

The address of the business.

phoneNumber

string

The phone number of the business.

customerService

object (AccountCustomerService)

The customer service information of the business.

AccountAddress

JSON representation
{
  "streetAddress": string,
  "locality": string,
  "region": string,
  "postalCode": string,
  "country": string
}
Fields
streetAddress

string

Street-level part of the address.

locality

string

City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).

region

string

Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").

postalCode

string

Postal code or ZIP (e.g. "94043").

country

string

CLDR country code (e.g. "US"). This value cannot be set for a sub-account of an MCA. All MCA sub-accounts inherit the country of their parent MCA.

AccountCustomerService

JSON representation
{
  "url": string,
  "email": string,
  "phoneNumber": string
}
Fields
url

string

Customer service URL.

email

string

Customer service email.

phoneNumber

string

Customer service phone number.

Methods

authinfo

Returns information about the authenticated user.

claimwebsite

Claims the website of a Merchant Center sub-account.

custombatch

Retrieves, inserts, updates, and deletes multiple Merchant Center (sub-)accounts in a single request.

delete

Deletes a Merchant Center sub-account.

get

Retrieves a Merchant Center account.

insert

Creates a Merchant Center sub-account.

Performs an action on a link between two Merchant Center accounts, namely accountId and linkedAccountId.

list

Lists the sub-accounts in your Merchant Center account.
Returns the list of accounts linked to your Merchant Center account.

update

Updates a Merchant Center account.

updatelabels

Updates labels that are assigned to the Merchant Center account by CSS user.