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: collectionstatuses
Stay organized with collections
Save and categorize content based on your preferences.
Resource: CollectionStatus
The collectionstatus message.
JSON representation |
{
"id": string,
"destinationStatuses": [
{
object (DestinationStatus )
}
],
"creationDate": string,
"lastUpdateDate": string,
"collectionLevelIssuses": [
{
object (ItemLevelIssue )
}
]
} |
Fields |
id |
string
Required. The ID of the collection for which status is reported.
|
destinationStatuses[] |
object (DestinationStatus )
The intended destinations for the collection.
|
creationDate |
string
Date on which the collection has been created in ISO 8601 format: Date, time, and offset, for example "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z"
|
lastUpdateDate |
string
Date on which the collection has been last updated in ISO 8601 format: Date, time, and offset, for example "2020-01-02T09:00:00+01:00" or "2020-01-02T09:00:00Z"
|
collectionLevelIssuses[] |
object (ItemLevelIssue )
A list of all issues associated with the collection.
|
DestinationStatus
Destination status message.
JSON representation |
{
"destination": string,
"status": string,
"approvedCountries": [
string
],
"pendingCountries": [
string
],
"disapprovedCountries": [
string
]
} |
Fields |
destination |
string
The name of the destination
|
status |
string
The status for the specified destination in the collections target country.
|
approvedCountries[] |
string
Country codes (ISO 3166-1 alpha-2) where the collection is approved.
|
pendingCountries[] |
string
Country codes (ISO 3166-1 alpha-2) where the collection is pending approval.
|
disapprovedCountries[] |
string
Country codes (ISO 3166-1 alpha-2) where the collection is disapproved.
|
ItemLevelIssue
Issue associated with the collection.
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 the serving of the collection.
|
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
Country codes (ISO 3166-1 alpha-2) where issue applies to the offer.
|
Methods |
|
Gets the status of a collection from your Merchant Center account. |
|
Lists the statuses of the collections 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\u003eThis documentation outlines the \u003ccode\u003eCollectionStatus\u003c/code\u003e, \u003ccode\u003eDestinationStatus\u003c/code\u003e, and \u003ccode\u003eItemLevelIssue\u003c/code\u003e resources, which provide information about the status of collections in Google Merchant Center.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eCollectionStatus\u003c/code\u003e resource gives an overview of a collection's status, including its intended destinations, creation and update dates, and any associated issues.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eDestinationStatus\u003c/code\u003e specifies the approval status of a collection in different countries for a specific destination.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eItemLevelIssue\u003c/code\u003e describes problems found within a collection, including their severity, resolution options, and affected attributes or destinations.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve information about collection statuses using the \u003ccode\u003eget\u003c/code\u003e and \u003ccode\u003elist\u003c/code\u003e methods of the \u003ccode\u003ecollectionstatuses\u003c/code\u003e resource.\u003c/p\u003e\n"]]],["The `CollectionStatus` resource provides information about a collection, including its ID, creation and last update dates, and associated issues. `DestinationStatus` details the status (approved, pending, disapproved) of a collection in specific countries and destinations. `ItemLevelIssue` describes issues impacting a collection, providing details like error code, servability, and applicable countries. Methods are available to retrieve (`get`) or list (`list`) collection statuses from a Merchant Center account.\n"],null,["# REST Resource: collectionstatuses\n\n- [Resource: CollectionStatus](#CollectionStatus)\n - [JSON representation](#CollectionStatus.SCHEMA_REPRESENTATION)\n- [DestinationStatus](#DestinationStatus)\n - [JSON representation](#DestinationStatus.SCHEMA_REPRESENTATION)\n- [ItemLevelIssue](#ItemLevelIssue)\n - [JSON representation](#ItemLevelIssue.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: CollectionStatus\n--------------------------\n\nThe collectionstatus message.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"destinationStatuses\": [ { object (/shopping-content/reference/rest/v2.1/collectionstatuses#DestinationStatus) } ], \"creationDate\": string, \"lastUpdateDate\": string, \"collectionLevelIssuses\": [ { object (/shopping-content/reference/rest/v2.1/collectionstatuses#ItemLevelIssue) } ] } ``` |\n\n| Fields ||\n|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string` Required. The ID of the collection for which status is reported. |\n| `destinationStatuses[]` | `object (`[DestinationStatus](/shopping-content/reference/rest/v2.1/collectionstatuses#DestinationStatus)`)` The intended destinations for the collection. |\n| `creationDate` | `string` Date on which the collection has been created in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format: Date, time, and offset, for example \"2020-01-02T09:00:00+01:00\" or \"2020-01-02T09:00:00Z\" |\n| `lastUpdateDate` | `string` Date on which the collection has been last updated in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format: Date, time, and offset, for example \"2020-01-02T09:00:00+01:00\" or \"2020-01-02T09:00:00Z\" |\n| `collectionLevelIssuses[]` | `object (`[ItemLevelIssue](/shopping-content/reference/rest/v2.1/collectionstatuses#ItemLevelIssue)`)` A list of all issues associated with the collection. |\n\nDestinationStatus\n-----------------\n\nDestination status message.\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` | `string` The status for the specified destination in the collections target country. |\n| `approvedCountries[]` | `string` Country codes (ISO 3166-1 alpha-2) where the collection is approved. |\n| `pendingCountries[]` | `string` Country codes (ISO 3166-1 alpha-2) where the collection is pending approval. |\n| `disapprovedCountries[]` | `string` Country codes (ISO 3166-1 alpha-2) where the collection is disapproved. |\n\nItemLevelIssue\n--------------\n\nIssue associated with the collection.\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 the serving of the collection. |\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` Country codes (ISO 3166-1 alpha-2) where issue applies to the offer. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------|------------------------------------------------------------------------|\n| ### [get](/shopping-content/reference/rest/v2.1/collectionstatuses/get) | Gets the status of a collection from your Merchant Center account. |\n| ### [list](/shopping-content/reference/rest/v2.1/collectionstatuses/list) | Lists the statuses of the collections in your Merchant Center account. |"]]