商品説明ページ（PDP）では、「Google で購入」で購入を完了する前に、買い物客に商品の機能とメリットが表示されます。Content API for Shopping を使用して豊富な商品データをアップロードすることで、充実した PDP を作成できます。詳細な商品データには、商品の機能やメリット、バリエーション商品、商品画像に関する情報が含まれます。
充実した商品データには他にも次のようなメリットがあります。
- ユーザーがニーズに合った商品を見つけられるよう、より詳細な商品説明を提供することで、商品検索を改善する
- 正確な商品情報を提供することで 自信を持って購入を決定し
- より明確に商品の価値を顧客に伝えることでコンバージョンを高める
このガイドでは、products.insert メソッドを使用して商品を作成するときに、Content API を使用してさまざまな商品データをアップロードする方法について説明します。以降のセクションでは、詳細な商品データを構成する products リソースの属性を含む部分的なリクエスト本文を説明します。完全な JSON リクエストについては、例: products.insert を使用してリッチ商品データをアップロードするをご覧ください。
商品 ID 属性
商品の id 属性は REST ID とも呼ばれ、channel、contentLanauge、feedLabel、offerId の各属性に指定した値から導出される一意の識別子です。例: online:en:US:1111111111リッチ商品データの場合は、すべての商品 ID 属性の値を指定します。
channel: 「online」または「local」contentLanguage: 2 文字の言語コード（「en」や「fr」など）feedLabel: 2 文字の言語コード（「US」や「FR」など）offerId: 販売者が提供する一意の識別子文字列
リクエストの例
"channel": "online",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"offerId": "1111111111"
商品タイトル
ブランド、性別、サイズ、色に関する情報など、商品に関する重要な詳細情報を title 属性に指定することで、ユーザーは適切な商品を見ているかどうかを簡単に確認できます。商品タイトルに関するその他のガイドラインと要件については、title: 定義をご覧ください。
リクエストの例
"title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White"
プロダクトの説明
description 属性で指定される詳細な商品説明により、仕様や画像では得られない方法で、商品について購入者に説明できます。商品説明に関するその他のガイドラインと要件については、description: 定義をご覧ください。
リクエストの例
"description": "The Google phone. MotionSense, an evolved camera, and the new
Google Assistant make Pixel 4 our most helpful phone yet. Studio-like photos.
Without the studio. Shoot without the flash. Capture rich detail and color, even
in the dark, with the next generation of Night Sight. Capture the cosmos. The
camera that can take photos of the Milky Way."
商品画像
imageLink 属性と additionalImageLinks 属性を使用して商品画像を指定して、商品説明ページを強化します。商品をさまざまな角度、さまざまな状況から撮影した高画質の画像を複数用意することをおすすめします。商品画像に関するその他のガイドラインと要件については、image_link: 定義をご覧ください。
リクエストの例
"imageLink": "https://example.com/gallery/500/image1.jpg",
"additionalImageLinks": [
"https://example.com/gallery/500/image2.jpg",
"https://example.com/gallery/500/image3.jpg",
"https://example.com/gallery/500/image4.jpg",
"https://example.com/gallery/500/image5.jpg"
]
商品バリエーション
itemGroupId 属性を使用して、類似商品のバリエーションの商品グループを定義できます。商品をグループ化する方法とタイミングに関するガイドライン、要件とベスト プラクティスについては、item_group_id: 定義をご覧ください。
リクエストの例
"itemGroupId": "pixels"
プロダクトに関する情報
商品説明ページの商品に関する情報セクションでは、メインの商品画像の横に商品の詳細の箇条書きリストが表示されます。productHighlights 属性を使用して、商品に関する情報セクションのアイテムのリストを指定します。商品に関する情報は少なくとも 5 つ提供することをおすすめします。商品に関する情報に関するその他のガイドラインと要件については、product_highlights: 定義をご覧ください。
リクエストの例
"productHighlights": [
"6GB RAM lets you enjoy multitasking conveniently",
"Touch screen feature offers user friendly interface",
"Its 16MP and 12MP rear cameras allow you capture high-quality pictures"
]
プロダクトの詳細
商品説明ページの商品詳細セクションでは、商品画像の下に追加の商品情報が表示されます（パソコン用ページとモバイルページでレイアウトが異なる場合があります）。productDetails 属性を使用して、商品の詳細オブジェクトのリストを指定します。各オブジェクトには、sectionName、attributeName、attributeValue 属性が含まれます。商品情報は少なくとも 6 つ指定することをおすすめします。商品の詳細に関するその他のガイドラインと要件については、product_detail: 定義をご覧ください。
リクエストの例
"productDetails": [
{
"sectionName": "General",
"attributeName": "Product Type",
"attributeValue": "Smartphone"
},
{
"sectionName": "Display",
"attributeName": "Resolution",
"attributeValue": "FHD Display 6GB RAM"
}
]
固有商品 ID（GTIN、ブランド、MPN）
Google では、商品を識別するために固有商品 ID を使用しています。各商品に GTIN 値を指定することを強くおすすめします。GTIN を指定しない場合は、Google が商品を識別できるようにブランドと MPN の両方の値を指定する必要があります。ID タイプについて詳しくは、固有商品 ID についてをご覧ください。
リクエストの例
"gtin": "842776114952",
"brand": "Google",
"mpn": "GA01188-US"
例: products.insert を使用して豊富な商品データをアップロードする
次の JSON サンプルは、リッチ商品データをアップロードするための products.insert 呼び出しのリクエストの例です。
POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products
{
"channel": "online",
"contentLanguage": "en",
"offerId": "pixel4",
"targetCountry": "US",
"feedLabel": "US",
"title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White",
"description": "The Google phone. Motion Sense, an evolved camera, and the new Google Assistant make Pixel 4 our most helpful phone yet. Studio-like photos. Without the studio. Shoot without the flash. Capture rich detail and color, even in the dark, with the next generation of Night Sight. Capture the cosmos. The camera that can take photos of the Milky Way.",
"imageLink": "https://example.com/gallery/500/image1.jpg",
"additionalImageLinks": [
"https://example.com/gallery/500/image2.jpg",
"https://example.com/gallery/500/image3.jpg",
"https://example.com/gallery/500/image4.jpg",
"https://example.com/gallery/500/image5.jpg"
],
"brand": "Google",
"googleProductCategory": "Electronics > Communications > Telephony > Mobile Phones",
"gtin": "842776114952",
"mpn": "GA01188-US",
"price": {
"currency": "USD",
"value": "549.99"
},
"salePrice": {
"currency": "USD",
"value": "549.99"
},
"productHighlights": [
"6GB RAM lets you enjoy multitasking conveniently",
"Touch screen feature offers user friendly interface",
"Its 16MP and 12MP rear cameras allow you capture high-quality pictures"
],
"productDetails": [
{
"sectionName": "General",
"attributeName": "Product Type",
"attributeValue": "Smartphone"
},
{
"sectionName": "Display",
"attributeName": "Resolution",
"attributeValue": "FHD Display 6GB RAM"
}
],
"availability": "in stock",
"condition": "new",
"includedDestinations": [
"Shopping Actions"
],
"excludedDestinations": [
"Shopping Ads"
],
"sellOnGoogleQuantity": 100,
"shippingLabel": "US_Test"
}