REST Resource: productstatuses

  • ProductStatus resource provides asynchronous information about a product, including its title, link, destinations, and any associated issues.

  • ProductStatusDestinationStatus indicates the approval status of a product in specific countries for each intended destination.

  • ProductStatusItemLevelIssue details specific problems with a product, including error codes, severity, resolution options, and affected countries.

  • You can access and manage product statuses using methods like custombatch, get, and list to retrieve information for single or multiple products.

Resource: ProductStatus

The status of a product, that is, information about a product computed asynchronously.

JSON representation 
{
  "productId": string,
  "title": string,
  "link": string,
  "destinationStatuses": [
    {
      object (ProductStatusDestinationStatus)
    }
  ],
  "kind": string,
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string,
  "itemLevelIssues": [
    {
      object (ProductStatusItemLevelIssue)
    }
  ]
}
Fields
productId

string

The ID of the product for which status is reported.
title

string

The title of the product.
destinationStatuses[]

object (ProductStatusDestinationStatus)

The intended destinations for the product.
kind

string

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

string

Date on which the item has been created, in ISO 8601 format.
lastUpdateDate

string

Date on which the item has been last updated, in ISO 8601 format.
googleExpirationDate

string

Date on which the item expires in Google Shopping, in ISO 8601 format.
itemLevelIssues[]

object (ProductStatusItemLevelIssue)

A list of all issues associated with the product.

ProductStatusDestinationStatus

JSON representation 
{
  "destination": string,
  "status": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Fields
destination

string

The name of the destination
status
(deprecated)

string

Deprecated. Destination approval status in targetCountry of the offer.
approvedCountries[]

string

productstatuses.list of country codes (ISO 3166-1 alpha-2) where the offer is approved.
pendingCountries[]

string

productstatuses.list of country codes (ISO 3166-1 alpha-2) where the offer is pending approval.
disapprovedCountries[]

string

productstatuses.list of country codes (ISO 3166-1 alpha-2) where the offer is disapproved.

ProductStatusItemLevelIssue

JSON representation 
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attributeName": string,
  "destination": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    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.
destination

string

The destination the issue applies to.
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.
applicableCountries[]

string

productstatuses.list of country codes (ISO 3166-1 alpha-2) where issue applies to the offer.

Methods

custombatch

 Gets the statuses of multiple products in a single request.

get

 Gets the status of a product from your Merchant Center account.

list

 Lists the statuses of the products in your Merchant Center account.