商品コレクション

商品コレクションを使用すると、 リッチフォーマットで使用する ショッピング画像。各 コレクションには最大 100 個の商品を含めることができます。コレクションを作成するには、 Google Merchant Center と Content API のどちらでも構いません

このガイドでは、Content API 経由で商品コレクションを使用する方法について説明します。 ショッピング画像のコレクションの作成方法や、 コレクションのステータスを確認することができます。

商品コレクションを使用する

Content API には、商品コレクションを管理するための 2 つのサービスがあります。

  • collections: 商品コレクションを取得、一覧表示、挿入、削除できます。

  • collectionstatuses: コレクションのステータスを取得して一覧表示できます。 エラーの原因となる問題がコレクションにあるかどうかを リンク先で無効（例: ショッピング広告。

例: ショッピング画像のコレクションを作成する

ショッピング画像は アノテーションが付けられた商品を 1 つ以上表示し、Google が事前 コレクションを使用します。ショッピング画像を使用するには、 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 エンドポイントに次の URL とリクエスト本文を使用します。

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 エンドポイントで次の URL を使用し、id を含めます。 ステータスを取得するコレクションの。1 対 1 の 作成します。

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"
    }
  ]
}