商品集合

商品集合可让您 定义要采用丰富格式的商品分组，例如 购物图片。每个 集合最多可包含 100 件商品。您可以使用 Google Merchant Center 或 Content API。

本指南介绍了如何通过 Content API 使用商品集合， 其中包括一些示例，说明如何创建购物图片集合，以及如何 来查看集合的状态

使用商品集合

Content API 包含两项用于管理商品集合的服务：

  • collections：可用于获取、列出、插入和删除商品集合。

  • collectionstatuses：可让您获取和列出集合的状态， 了解某个集合是否存在可能会导致该集合 对目标平台无效，例如 购物广告。

示例：为购物图片创建集合

购物图片的 显示一个或多个带注释的商品的优质图片， 使用集合要使用购物图片，您必须为 imageLink 和 featuredProduct 字段，以及 所有集合。如需详细了解必填字段，请参阅 Content API 参考文档。

要使用购物图片，您必须创建商品集合，并使用 imageLink 字段用于指定最多包含 10 件商品的图片。周三 建议使用方形图片（宽高比为 1:1）。

您还必须使用 featuredProduct 字段，包括图片中商品的坐标 使用 x 和 y 字段指定值。只有集合才需要这些字段 与购物图片搭配使用x 和 y 的值必须介于 0 到 1 之间。 （含边界值）。

每个集合最多可包含 100 件商品。但是，对于 购物图片，我们建议您指定不超过 10 张 每张图片有足够大的空间来展示 产品宣传信息。通过 offerId 属于 featuredProduct 对象的字段必须与 offerId 匹配 products资源的值，它不同于 id 值 （针对 products 资源）。

除了 imageLink 和 featuredProduct 字段之外，这两个字段是必填字段 对于购物图片，您还可以使用 可选的 headline 字段。我们建议您添加一个标题 向客户提供有关合集的更多详细信息。

要为购物图片创建新集合，请向POST collections.insert 端点，并使用以下网址和请求正文：

https://shoppingcontent.googleapis.com/content/v2.1/merchantId/collections

{
  "id": "exampleCollection"
  "language": "en",
  "productCountry": "UK",
  "imageLink": ["www.imageLink.example"],
  "featuredProduct": [
{
  "offerId": '432',
  "x": 0.11,
  "y": 0.99
},
{ "offerId": '433',
  "x": 0.53,
  "y": 0.89
}
],
  "link": "www.link.example",
  "mobileLink": "www.mobileLink.example",
  "headline": "www.link.example",
  "customLabel0": "Organize",
  "customLabel1": "Your",
  "customLabel2": "Bidding/Reporting",
  "customLabel3": "With",
  "customLabel4": "Me"
}

示例：查看集合的状态

了解您在上面创建的集合是否存在 使数据收集失效，请GET向 collectionsstatuses.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"
    }
  ]
}