可在商品说明页面上使用丰富的商品数据

商品说明页面 (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：“在线”或“本地”
  • contentLanguage：双字母语言代码，例如“en”或“fr”
  • feedLabel：双字母语言代码，例如“US”或“FR”
  • offerId：商家提供的唯一标识符字符串

示例请求

"channel": "online",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"offerId": "1111111111"

产品名称

在 title 属性中添加关键商品详情（例如品牌、适用性别、尺码和颜色）有助于客户快速确定自己查看的是否是正确的商品。如需了解商品名方面的其他准则和要求，请参阅商品名：定义。

示例请求

"title": "Google Pixel 4 64GB Unlocked Smartphone 5.7' FHD Display 6GB RAM 4G Clear White"

产品描述

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

唯一商品标识码（GTIN、品牌、MPN）

Google 使用唯一商品标识码来标识商品。我们强烈建议您为每件商品提供 GTIN 值。如果您不提供 GTIN，则必须同时提供品牌和 MPN 的值，以便我们识别您的商品。如需详细了解标识码类型，请参阅唯一商品标识码简介。

示例请求

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