Accounts

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

Resource representations

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

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
    }
  ],
  "youtubeChannelLinks": [
    {
      "channelId": string,
      "status": string
    }
  ],
  "googleMyBusinessLink": {
    "gmbEmail": string,
    "status": string
  },
  "businessInformation": {
    "address": {
      "streetAddress": string,
      "locality": string,
      "region": string,
      "postalCode": string,
      "country": string
    },
    "phoneNumber": string,
    "customerService": {
      "url": string,
      "email": string,
      "phoneNumber": string
    }
  }
}
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"
businessInformation nested object The business information of the account. writable
businessInformation.address nested object The address of the business. writable
businessInformation.address.country string CLDR country code (e.g. "US").
businessInformation.address.locality string City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). writable
businessInformation.address.postalCode string Postal code or ZIP (e.g. "94043"). writable
businessInformation.address.region string Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC"). writable
businessInformation.address.streetAddress string Street-level part of the address. writable
businessInformation.customerService nested object The customer service information of the business. writable
businessInformation.customerService.email string Customer service email. writable
businessInformation.customerService.phoneNumber string Customer service phone number. writable
businessInformation.customerService.url string Customer service URL. writable
businessInformation.phoneNumber string The phone number of the business. writable
googleMyBusinessLink.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. writable
googleMyBusinessLink.status string Status of the link between this Merchant Center account and the GMB account.

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 [DEPRECATED] This field is never returned and will be ignored if provided.
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>
  <youtube_channel_links>
    (foreach)
      <youtube_channel_link>
        <channel_id>
          string
        </channel_id>
        <status>
          string
        </status>
      </youtube_channel_link>
    (/foreach)
  </youtube_channel_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. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, patch, and update require the admin role.
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 [DEPRECATED] This field is never returned and will be ignored if provided.
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.
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 a Merchant Center account and another account.
list
Lists the sub-accounts in your Merchant Center account.
patch
Updates a Merchant Center account. This method supports patch semantics.
update
Updates a Merchant Center account.

Enviar comentarios sobre…

Content API for Shopping