Accounts

For a list of methods for this resource, see the end of this page.

Resource representations

Account data.

JSON

{
  "kind": "content#account",
  "id": unsigned long,
  "name": string,
  "websiteUrl": string,
  "adultContent": boolean,
  "sellerId": string,
  "reviewsUrl": string,
  "adwordsLinks": [
    {
      "adwordsId": unsigned long,
      "status": string
    }
  ],
  "users": [
    {
      "emailAddress": string,
      "admin": boolean
    }
  ]
}
Property name Value Description Notes
adultContent boolean Indicates whether the merchant sells adult content. writable
adwordsLinks[].adwordsId unsigned long Customer ID of the AdWords account. writable
adwordsLinks[].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"
  • "inactive"
  • "pending"
id unsigned long Merchant Center account ID.
kind string Identifies what kind of resource this is. Value: the fixed string "content#account".
name string Display name for the account. writable
reviewsUrl string URL for individual seller reviews, i.e., reviews for each child account. writable
sellerId string Client-specific, locally-unique, internal ID for the child account. writable
users[] list Users with access to the account. Every account (except for subaccounts) must have at least one admin user. writable
users[].admin boolean Whether user is an admin. writable
users[].emailAddress string User's email address. writable
websiteUrl string The merchant's website. writable

XML

<account>
  <id>
    unsigned long
  </id>
  <name>
    string
  </name>
  <website_url>
    string
  </website_url>
  <adult_content>
    boolean
  </adult_content>
  <seller_id>
    string
  </seller_id>
  <reviews_url>
    string
  </reviews_url>
  <adwords_links>
    (foreach)
      <adwords_link>
        <adwords_id>
          unsigned long
        </adwords_id>
        <status>
          string
        </status>
      </adwords_link>
    (/foreach)
  </adwords_links>
  <users>
    (foreach)
      <user>
        <email_address>
          string
        </email_address>
        <admin>
          boolean
        </admin>
      </user>
    (/foreach)
  </users>
</account>
Property name Value Description Notes
account object Account data.
account/adult_content boolean Indicates whether the merchant sells adult content. writable
account/adwords_links/adwords_link/adwords_id unsigned long Customer ID of the AdWords account. writable
account/adwords_links/adwords_link/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"
  • "inactive"
  • "pending"
account/id unsigned long Merchant Center account ID.
account/name string Display name for the account. writable
account/reviews_url string URL for individual seller reviews, i.e., reviews for each child account. writable
account/seller_id string Client-specific, locally-unique, internal ID for the child account. writable
account/users object
account/users/user object Users with access to the account. Every account (except for subaccounts) must have at least one admin user. writable
account/users/user/admin boolean Whether user is an admin. writable
account/users/user/email_address string User's email address. writable
account/website_url string The merchant's website. writable

Methods

authinfo
Returns information about the authenticated user.
claimwebsite
Claims the website of a Merchant Center sub-account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.
custombatch
Retrieves, inserts, updates, and deletes multiple Merchant Center (sub-)accounts in a single request.
delete
Deletes a Merchant Center sub-account. This method can only be called for multi-client accounts.
get
Retrieves a Merchant Center account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.
insert
Creates a Merchant Center sub-account. This method can only be called for multi-client accounts.
list
Lists the sub-accounts in your Merchant Center account. This method can only be called for multi-client accounts.
patch
Updates a Merchant Center account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account. This method supports patch semantics.
update
Updates a Merchant Center account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.

Send feedback about...

Content API for Shopping