商品コレクションを使用すると、ショッピング画像などのリッチ フォーマットで使用する商品のグループを定義できます。各コレクションには最大 100 個の商品を含めることができます。コレクションは、Google Merchant Center または Content API で作成できます。
このガイドでは、Content API を使用して商品コレクションを使用する方法について説明します。これには、購入可能な画像のコレクションを作成する方法や、コレクションのステータスを確認する方法の例が含まれます。
商品コレクションを使用する
Content API には、商品コレクションを管理するための 2 つのサービスが含まれています。
collections: 商品コレクションの取得、一覧表示、挿入、削除を行うことができます。collectionstatuses: コレクションのステータスを取得して一覧表示し、コレクションが ショッピング広告などの掲載先で無効になる原因となる問題があるかどうかを確認できます。
例: ショッピング画像のコレクションを作成する
ショッピング画像は、アノテーションを付けた商品または商品グループを表示するための高画質の画像で、コレクションを使用して設定されます。ショッピング画像を使用するには、すべてのコレクションに必要なフィールドに加えて、imageLink フィールドと featuredProduct フィールドの値を指定する必要があります。必須フィールドの詳細については、Content API リファレンス ドキュメントをご覧ください。
ショッピング画像を使用するには、商品のコレクションを作成し、imageLink フィールドを使用して最大 10 個の商品を含む画像を指定する必要があります。正方形の画像（アスペクト比 1:1）を使用することをおすすめします。
また、featuredProduct フィールドを使用して画像に表示されている商品を指定する必要があります。これには、x フィールドと y フィールドを使用して画像内の商品の座標を指定することも含まれます。これらのフィールドは、ショッピング画像で使用されるコレクションでのみ必須です。x と y の値は 0 ～ 1 の範囲で指定する必要があります（最小値と最大値を範囲に含む）。
各コレクションには最大 100 個の商品を含めることができます。ただし、ショッピング画像では、商品コールアウトを表示するのに十分なスペースを確保するため、画像ごとに 10 個以下の商品の座標を指定することをおすすめします。featuredProduct オブジェクトの一部である offerId フィールドは、products リソースの offerId 値と一致する必要があります。これは、products リソースの id 値とは異なります。
ショッピング画像に必要な imageLink フィールドと featuredProduct フィールドに加えて、オプションの headline フィールドを使用してコレクションの見出しを指定することもできます。コレクションに関する詳細情報をユーザーに提供するため、見出しを含めることをおすすめします。
ショッピング画像の新しいコレクションを作成するには、次の URL とリクエスト本文を使用して collections.insert エンドポイントに POST リクエストを送信します。
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"
}
例: コレクションのステータスを確認する
上記で作成したコレクションに、広告の配信を無効にする問題があるかどうかを確認するには、次の URL を使用して 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"
}
]
}