REST Resource: accounts

• Resource: Account
  • JSON representation
• AccountAdwordsLink
  • JSON representation
• AccountUser
  • JSON representation
• AccountYouTubeChannelLink
  • JSON representation
• AccountGoogleMyBusinessLink
  • JSON representation
• AccountBusinessInformation
  • JSON representation
• AccountAddress
  • JSON representation
• AccountCustomerService
  • JSON representation
• Methods

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.
adwordsLinks[]	object (AccountAdwordsLink) accounts.list of linked AdWords accounts that are active or pending approval. To create a new link request, add a new link with status active to the list. It will remain in a pending state until approved or rejected either in the AdWords interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list.
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.
youtubeChannelLinks[]	object (AccountYouTubeChannelLink) accounts.list of linked YouTube channels that are active or pending approval. To create a new link request, add a new link with status active to the list. It will remain in a pending state until approved or rejected in the YT Creator Studio interface. To delete an active link, or to cancel a link request, remove it from the list.
googleMyBusinessLink	object (AccountGoogleMyBusinessLink) The GMB account which is linked or in the process of being linked with the Merchant Center account.
businessInformation	object (AccountBusinessInformation) The business information of the account.

AccountAdwordsLink

JSON representation
{ "adwordsId": string, "status": string }

Fields
adwordsId	string Customer ID of the AdWords account.
status	string Status of the link between this Merchant Center account and the AdWords account. Upon retrieval, it represents the actual status of the link and can be either active if it was approved in Google AdWords or pending if it's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it's already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status inactive is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending. Acceptable values are: "active" "pending"

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.

AccountYouTubeChannelLink

JSON representation
{ "channelId": string, "status": string }

Fields
channelId	string Channel ID.
status	string Status of the link between this Merchant Center account and the YouTube channel. Upon retrieval, it represents the actual status of the link and can be either active if it was approved in YT Creator Studio or pending if it's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it's already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status inactive is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending.

AccountGoogleMyBusinessLink

JSON representation
{ "gmbEmail": string, "status": string }

Fields
gmbEmail	string The GMB email address of which a specific account within a GMB account. A sample account within a GMB account could be a business account with set of locations, managed under the GMB account.
status	string Status of the link between this Merchant Center account and the GMB account. Acceptable values are: "active" "pending"

AccountBusinessInformation

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

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.
koreanBusinessRegistrationNumber	string The 10-digit Korean business registration number separated with dashes in the format: XXX-XX-XXXXX. This field will only be updated if explicitly set.

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