產品素材資源集合

產品集合可讓您 定義要搭配多媒體格式使用的產品群組，例如 可購物圖片。每項 產品素材資源集合最多可以包含 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"
    }
  ]
}