rocket
Meet
Merchant API
- the official successor to Content API for Shopping.
update
Get the latest
on new Merchant API features, bug fixes, and updates.
add_alert
Note: Content API for Shopping will be sunset on August 18, 2026.
REST Resource: productstatuses
Stay organized with collections
Save and categorize content based on your preferences.
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.
|
link |
string
The link to 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 |
|
|
Gets the statuses of multiple products in a single request. |
|
|
Gets the status of a product from your Merchant Center account. |
|
|
Lists the statuses of the products in your Merchant Center account. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-25 UTC.
[null,null,["Last updated 2025-02-25 UTC."],[[["\u003cp\u003e\u003ccode\u003eProductStatus\u003c/code\u003e resource provides asynchronous information about a product, including its title, link, destinations, and any associated issues.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eProductStatusDestinationStatus\u003c/code\u003e indicates the approval status of a product in specific countries for each intended destination.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eProductStatusItemLevelIssue\u003c/code\u003e details specific problems with a product, including error codes, severity, resolution options, and affected countries.\u003c/p\u003e\n"],["\u003cp\u003eYou can access and manage product statuses using methods like \u003ccode\u003ecustombatch\u003c/code\u003e, \u003ccode\u003eget\u003c/code\u003e, and \u003ccode\u003elist\u003c/code\u003e to retrieve information for single or multiple products.\u003c/p\u003e\n"]]],["The provided content outlines the structure and methods for managing product status information. Key details include: `ProductStatus` with fields like `productId`, `title`, `destinationStatuses`, and `itemLevelIssues`; `ProductStatusDestinationStatus` indicating approval status across different countries; and `ProductStatusItemLevelIssue`, which details issues with codes, servability, and resolution guidance. The methods available allow retrieval of statuses via `custombatch`, `get`, and `list` functionalities.\n"],null,["# REST Resource: productstatuses\n\n- [Resource: ProductStatus](#ProductStatus)\n - [JSON representation](#ProductStatus.SCHEMA_REPRESENTATION)\n- [ProductStatusDestinationStatus](#ProductStatusDestinationStatus)\n - [JSON representation](#ProductStatusDestinationStatus.SCHEMA_REPRESENTATION)\n- [ProductStatusItemLevelIssue](#ProductStatusItemLevelIssue)\n - [JSON representation](#ProductStatusItemLevelIssue.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: ProductStatus\n-----------------------\n\nThe status of a product, that is, information about a product computed asynchronously.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"productId\": string, \"title\": string, \"link\": string, \"destinationStatuses\": [ { object (/shopping-content/reference/rest/v2.1/productstatuses#ProductStatusDestinationStatus) } ], \"kind\": string, \"creationDate\": string, \"lastUpdateDate\": string, \"googleExpirationDate\": string, \"itemLevelIssues\": [ { object (/shopping-content/reference/rest/v2.1/productstatuses#ProductStatusItemLevelIssue) } ] } ``` |\n\n| Fields ||\n|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `productId` | `string` The ID of the product for which status is reported. |\n| `title` | `string` The title of the product. |\n| `link` | `string` The link to the product. |\n| `destinationStatuses[]` | `object (`[ProductStatusDestinationStatus](/shopping-content/reference/rest/v2.1/productstatuses#ProductStatusDestinationStatus)`)` The intended destinations for the product. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string \"`content#productStatus`\" |\n| `creationDate` | `string` Date on which the item has been created, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. |\n| `lastUpdateDate` | `string` Date on which the item has been last updated, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. |\n| `googleExpirationDate` | `string` Date on which the item expires in Google Shopping, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. |\n| `itemLevelIssues[]` | `object (`[ProductStatusItemLevelIssue](/shopping-content/reference/rest/v2.1/productstatuses#ProductStatusItemLevelIssue)`)` A list of all issues associated with the product. |\n\nProductStatusDestinationStatus\n------------------------------\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"destination\": string, \"status\": string, \"approvedCountries\": [ string ], \"pendingCountries\": [ string ], \"disapprovedCountries\": [ string ] } ``` |\n\n| Fields ||\n|---------------------------|--------------------------------------------------------------------------------------------------------------|\n| `destination` | `string` The name of the destination |\n| `status` **(deprecated)** | `string` | This item is deprecated! Deprecated. Destination approval status in `targetCountry` of the offer. |\n| `approvedCountries[]` | `string` productstatuses.list of country codes (ISO 3166-1 alpha-2) where the offer is approved. |\n| `pendingCountries[]` | `string` productstatuses.list of country codes (ISO 3166-1 alpha-2) where the offer is pending approval. |\n| `disapprovedCountries[]` | `string` productstatuses.list of country codes (ISO 3166-1 alpha-2) where the offer is disapproved. |\n\nProductStatusItemLevelIssue\n---------------------------\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"code\": string, \"servability\": string, \"resolution\": string, \"attributeName\": string, \"destination\": string, \"description\": string, \"detail\": string, \"documentation\": string, \"applicableCountries\": [ string ] } ``` |\n\n| Fields ||\n|-------------------------|-------------------------------------------------------------------------------------------------------|\n| `code` | `string` The error code of the issue. |\n| `servability` | `string` How this issue affects serving of the offer. |\n| `resolution` | `string` Whether the issue can be resolved by the merchant. |\n| `attributeName` | `string` The attribute's name, if the issue is caused by a single attribute. |\n| `destination` | `string` The destination the issue applies to. |\n| `description` | `string` A short issue description in English. |\n| `detail` | `string` A detailed issue description in English. |\n| `documentation` | `string` The URL of a web page to help with resolving this issue. |\n| `applicableCountries[]` | `string` productstatuses.list of country codes (ISO 3166-1 alpha-2) where issue applies to the offer. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------|---------------------------------------------------------------------|\n| ### [custombatch](/shopping-content/reference/rest/v2.1/productstatuses/custombatch) | Gets the statuses of multiple products in a single request. |\n| ### [get](/shopping-content/reference/rest/v2.1/productstatuses/get) | Gets the status of a product from your Merchant Center account. |\n| ### [list](/shopping-content/reference/rest/v2.1/productstatuses/list) | Lists the statuses of the products in your Merchant Center account. |"]]