REST Resource: accountstatuses

  • AccountStatus resource provides an overview of a Merchant Center account's health, including product data, account issues, and website claim status.

  • It details account-level and item-level issues, offering insights into data quality and potential areas for improvement.

  • Statistics on active, pending, disapproved, and expiring offers are available for products, segmented by channel, destination, and country.

  • You can retrieve account statuses individually, in batches, or as a list for sub-accounts using the provided methods.

  • Developers can access this data programmatically through the Shopping Content API for monitoring and automation purposes.

Resource: AccountStatus

The status of an account, that is, information about its products, which is computed offline and not returned immediately at insertion time.

JSON representation 
{
  "accountId": string,
  "kind": string,
  "websiteClaimed": boolean,
  "accountLevelIssues": [
    {
      object (AccountStatusAccountLevelIssue)
    }
  ],
  "products": [
    {
      object (AccountStatusProducts)
    }
  ],
  "accountManagement": string
}
Fields
accountId

string

The ID of the account for which the status is reported.
kind

string

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

boolean

Whether the account's website is claimed or not.
accountLevelIssues[]

object (AccountStatusAccountLevelIssue)

A list of account level issues.
products[]

object (AccountStatusProducts)

accountstatuses.list of product-related data by channel, destination, and country. Data in this field may be delayed by up to 30 minutes.
accountManagement

string

How the account is managed.

Acceptable values are:

  • "manual"
  • "automatic"

AccountStatusAccountLevelIssue

JSON representation 
{
  "id": string,
  "title": string,
  "country": string,
  "severity": string,
  "detail": string,
  "destination": string,
  "documentation": string
}
Fields
id

string

Issue identifier.
title

string

Short description of the issue.
country

string

Country for which this issue is reported.
severity

string

Severity of the issue.

Acceptable values are:

  • "critical"
  • "error"
  • "suggestion"
detail

string

Additional details about the issue.
destination

string

The destination the issue applies to. If this field is empty then the issue applies to all available destinations.
documentation

string

The URL of a web page to help resolving this issue.

AccountStatusProducts

JSON representation 
{
  "channel": string,
  "destination": string,
  "country": string,
  "statistics": {
    object (AccountStatusStatistics)
  },
  "itemLevelIssues": [
    {
      object (AccountStatusItemLevelIssue)
    }
  ]
}
Fields
channel

string

The channel the data applies to.

Acceptable values are:

  • "local"
  • "online"
destination

string

The destination the data applies to.
country

string

The country the data applies to.
statistics

object (AccountStatusStatistics)

Aggregated product statistics.
itemLevelIssues[]

object (AccountStatusItemLevelIssue)

accountstatuses.list of item-level issues.

AccountStatusStatistics

JSON representation 
{
  "active": string,
  "pending": string,
  "disapproved": string,
  "expiring": string
}
Fields
active

string (int64 format)

Number of active offers.
pending

string (int64 format)

Number of pending offers.
disapproved

string (int64 format)

Number of disapproved offers.
expiring

string (int64 format)

Number of expiring offers.

AccountStatusItemLevelIssue

JSON representation 
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attributeName": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "numItems": string
}
Fields
code

string

The error code of the issue.
servability

string

How this issue affects serving of the offer.
resolution

string

Whether the issue can be resolved by the merchant.
attributeName

string

The attribute's name, if the issue is caused by a single attribute.
description

string

A short issue description in English.
detail

string

A detailed issue description in English.
documentation

string

The URL of a web page to help with resolving this issue.
numItems

string (int64 format)

Number of items with this issue.

Methods

custombatch

 Retrieves multiple Merchant Center account statuses in a single request.

get

 Retrieves the status of a Merchant Center account.

list

 Lists the statuses of the sub-accounts in your Merchant Center account.