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,
  "reviewsUrl": string,
  "adwordsLinks": [
    {
      object (AccountAdwordsLink)
    }
  ],
  "users": [
    {
      object (AccountUser)
    }
  ],
  "id": string,
  "youtubeChannelLinks": [
    {
      object (AccountYouTubeChannelLink)
    }
  ],
  "googleMyBusinessLink": {
    object (AccountGoogleMyBusinessLink)
  },
  "businessInformation": {
    object (AccountBusinessInformation)
  }
}
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.

reviewsUrl

string

[DEPRECATED] This field is never returned and will be ignored if provided.

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.

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

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.

link

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.

update

Updates a Merchant Center account.