如需了解您创建的上述集合是否存在会导致该集合无法投放广告的问题,请使用以下网址向 collectionsstatuses.get 端点发出 GET 请求,并添加您要检索其状态的集合的 id。您不必提供请求正文。
https://shoppingcontent.googleapis.com/content/v2.1/merchantID/collectionstatuses/collection ID
集合状态响应示例
{"id":"exampleCollection","creationDate":"2020-09-22T00:26:51Z","lastUpdateDate":"2020-09-22T00:26:51Z","collectionLevelIssues":[{"code":"invalid_url","servability":"unaffected","resolution":"merchant_action","attributeName":"link","description":"Invalid URL [link]","detail":"Use a complete URL that starts with http:// or https:// and links to a valid destination such as an image or a landing page","documentation":"https://support.google.com/merchants/answer/7052112"},{"code":"invalid_url","servability":"unaffected","resolution":"merchant_action","attributeName":"imageLink","description":"Invalid URL [imageLink]","detail":"Use a complete URL that starts with http:// or https:// and links to a valid destination such as an image or a landing page","documentation":"https://support.google.com/merchants/answer/7052112"}]}
[null,null,["最后更新时间 (UTC):2025-08-13。"],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and allows management of product collections.\u003c/p\u003e\n"],["\u003cp\u003eProduct collections can be used to create Shoppable Images, which are high-quality images with annotated products.\u003c/p\u003e\n"],["\u003cp\u003eTwo services, \u003ccode\u003ecollections\u003c/code\u003e and \u003ccode\u003ecollectionstatuses\u003c/code\u003e, are available for managing and checking the status of collections.\u003c/p\u003e\n"],["\u003cp\u003eWhen creating a collection for Shoppable Images, specific fields like \u003ccode\u003eimageLink\u003c/code\u003e and \u003ccode\u003efeaturedProduct\u003c/code\u003e are required.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ecollectionstatuses\u003c/code\u003e service helps identify any issues with a collection that might affect its use in ads.\u003c/p\u003e\n"]]],["The Merchant API beta introduces product collections, groups of up to 100 products for use with rich formats like Shoppable Images. Collections can be managed via the Content API's `collections` service for creating, retrieving, updating, and deleting. The `collectionstatuses` service allows users to identify issues that may affect ad serving, like invalid URLs. To create a collection for Shoppable Images, use a `POST` request to `collections.insert`, including `imageLink` and `featuredProduct` fields. You can use a `GET` request to `collectionsstatuses.get` to check the status of collections.\n"],null,["# Product collections\n\n[Product collections](//support.google.com/merchants/answer/9699507) let you\ndefine groups of products to use with rich formats, such as\n[Shoppable Images](//support.google.com/merchants/answer/9700018). Each\ncollection can include up to 100 products. You can create a collection with\neither the Google Merchant Center or the Content API.\n\nThis guide shows how to use product collections through the Content API,\nincluding examples for how to create a collection for Shoppable Images and how\nto check the status of a collection.\n| **Note:** Shoppable Images is currently the only ad format that supports collections. However, additional formats may be added so that you can re-use your collections across different ad formats.\n\nUse product collections\n-----------------------\n\nThe Content API includes two services to manage product collections:\n\n- `collections`: Lets you get, list, insert, and delete product collections.\n\n- `collectionstatuses`: Lets you get and list the status of collections to\n discover whether a collection has any issues that may cause the collection to\n be invalid for a destination, such as\n [Shopping Ads](//support.google.com/merchants/answer/9455869).\n\n### Example: Create a collection for Shoppable Images\n\n[Shoppable Images](//support.google.com/merchants/answer/9700018) are high-\nquality images which show one or more annotated products, and are configured\nusing collections. To use Shoppable Images, you must specify values for the\n`imageLink` and `featuredProduct` fields, in addition to the fields required for\nall collections. For more information about required fields, see the\n[Content API reference documentation](/shopping-content/reference/rest/v2.1).\n\nTo use Shoppable Images, you must create a collection of products and use the\n`imageLink` field to specify an image that contains up to ten products. We\nrecommend using square images (with a 1:1 aspect ratio).\n| **Key Point:** The `imageLink` field for collections accepts an array of image link values. However, only the first value in the array is used for the Shoppable Images format.\n\nYou must also specify the products displayed in the image using the\n`featuredProduct` field, including the coordinates of the products in the image\nusing the `x` and `y` fields. These fields are only required for collections\nused with Shoppable Images. The `x` and `y` values must be between 0 and 1,\ninclusive.\n\nEach collection can include a maximum of 100 products. However, for\nShoppable Images, we recommend that you specify coordinates for no more than 10\nproducts per image to ensure that there is enough space on the image to show the\nproduct callouts. The\n[`offerId`](/shopping-content/reference/rest/v2.1/products#Product.FIELDS.offer_id)\nfield that is part of the `featuredProduct` object must match the `offerId`\nvalue on the `products` resource, which is different from the\n[`id`](/shopping-content/reference/rest/v2.1/products#Product.FIELDS.id) value\non the `products` resource.\n\nIn addition to the `imageLink` and `featuredProduct` fields, which are required\nfor Shoppable Images, you can also specify a collection headline using the\noptional `headline` field. We recommend including a headline to provide\ncustomers with additional details about the collection.\n| **Key Point:** The `headline` field for collections accepts an array of headline values. However, only the first value in the array is used for the Shoppable Images format.\n\nTo create a new collection for Shoppable Images, make a `POST` request to the\n`collections.insert` endpoint using the following URL and request body: \n\n https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003emerchantId\u003c/var\u003e/collections\n\n {\n \"id\": \"exampleCollection\"\n \"language\": \"en\",\n \"productCountry\": \"UK\",\n \"imageLink\": [\"www.imageLink.example\"],\n \"featuredProduct\": [\n {\n \"offerId\": '432',\n \"x\": 0.11,\n \"y\": 0.99\n },\n { \"offerId\": '433',\n \"x\": 0.53,\n \"y\": 0.89\n }\n ],\n \"link\": \"www.link.example\",\n \"mobileLink\": \"www.mobileLink.example\",\n \"headline\": \"www.link.example\",\n \"customLabel0\": \"Organize\",\n \"customLabel1\": \"Your\",\n \"customLabel2\": \"Bidding/Reporting\",\n \"customLabel3\": \"With\",\n \"customLabel4\": \"Me\"\n }\n\n| **Warning:** If a collection exists with the same `id`, making a request to `collections.insert` replaces the resource entirely.\n\n### Example: Check the status of a collection\n\nTo discover whether the collection you created above has issues that would\ninvalidate the collection from serving ads, make a `GET` request to the\n`collectionsstatuses.get` endpoint using the following URL, and include the `id`\nof the collection whose status you want to retrieve. You do not have to provide\na request body. \n\n https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003emerchantID\u003c/var\u003e/collectionstatuses/\u003cvar translate=\"no\"\u003ecollection ID\u003c/var\u003e\n\n#### Example collection status response\n\n {\n \"id\": \"exampleCollection\",\n \"creationDate\": \"2020-09-22T00:26:51Z\",\n \"lastUpdateDate\": \"2020-09-22T00:26:51Z\",\n \"collectionLevelIssues\": [\n {\n \"code\": \"invalid_url\",\n \"servability\": \"unaffected\",\n \"resolution\": \"merchant_action\",\n \"attributeName\": \"link\",\n \"description\": \"Invalid URL [link]\",\n \"detail\": \"Use a complete URL that starts with http:// or https:// and\n links to a valid destination such as an image or a landing page\",\n \"documentation\": \"https://support.google.com/merchants/answer/7052112\"\n },\n {\n \"code\": \"invalid_url\",\n \"servability\": \"unaffected\",\n \"resolution\": \"merchant_action\",\n \"attributeName\": \"imageLink\",\n \"description\": \"Invalid URL [imageLink]\",\n \"detail\": \"Use a complete URL that starts with http:// or https:// and\n links to a valid destination such as an image or a landing page\",\n \"documentation\": \"https://support.google.com/merchants/answer/7052112\"\n }\n ]\n }"]]