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

商品说明页面 (PDP) 用于向买家展示商品的功能和优势，然后再通过“在 Google 上购买”完成购买。您可以通过 Content API for Shopping 上传丰富的商品数据，从而制作内容丰富的 PDP。丰富的商品数据包括有关商品的特性和优势、商品款式/规格和商品图片的信息。

丰富商品数据的其他优势包括：

• 提供更详细的商品说明，帮助客户找到符合自己需求的商品，让更多人发现您的商品
• 通过提供准确的产品信息来提升客户信任度，让客户做出信心十足的购买决策
• 通过更清晰地向客户传达产品的价值，帮助提高转化率

本指南介绍了在使用 products.insert 方法创建商品时，如何使用 Content API 上传丰富的商品数据。以下各部分提供了部分请求正文，其中包含构成丰富商品数据的 products 资源的属性。如需查看完整的 JSON 请求，请参阅示例：使用 products.insert 上传丰富的商品数据。

注意 ：如需详细了解内容丰富的商品说明页面，包括如何在 Merchant Center 中添加丰富的商品数据，请参阅为“在 Google 上购买”创建内容丰富的商品说明页面。

商品 ID 属性

商品的 id 属性（也称为 REST ID）是一个唯一标识符，源自您为 channel、contentLanauge、feedLabel 和 offerId 属性提供的值。例如 online:en:US:1111111111。对于丰富的商品数据，请添加所有商品 ID 属性的值：

• channel：“online”或“local”
• contentLanguage：双字母语言代码，例如“en”或“fr”
• feedLabel：双字母语言代码，例如“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 属性提供丰富的商品说明，能够以规格和图片无法提供的方式向客户介绍商品。如需了解产品说明的其他准则和要求，请参阅说明：定义。

注意 ：Google 可能会根据商品的唯一 GTIN 的匹配项设置商品说明的格式。

示例请求

"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 属性为商品亮点部分提供商品列表。我们建议您至少提供五个商品亮点。如需了解商品亮点的其他准则和要求，请参阅 product_highlights：定义。

注意 ：Google 可能会根据与商品唯一 GTIN 的匹配情况修改商品亮点部分的内容。

示例请求

"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 [商品详情]：定义。

注意 ：提供的商品详情必须与商品 GTIN 的详细信息一致。

示例请求

  "productDetails": [
    {
      "sectionName": "General",
      "attributeName": "Product Type",
      "attributeValue": "Smartphone"
    },
    {
      "sectionName": "Display",
      "attributeName": "Resolution",
      "attributeValue": "FHD Display 6GB RAM"
    }
  ]

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

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

注意 ：Google 标识符也会用于将商品与评价数据（如果有）进行匹配。如需详细了解如何提供评价数据，请参阅商品评分提交选项。

示例请求

"gtin": "842776114952",
"brand": "Google",
"mpn": "GA01188-US"

示例：使用 products.insert 上传丰富的商品数据

以下 JSON 示例展示了一个用于调用 products.insert 来上传丰富商品数据的请求示例。

警告 ：默认情况下，调用 products.insert 来更新现有商品会将所有商品数据替换为请求正文中提供的字段。如需详细了解如何在不替换现有商品数据的情况下更新商品，请参阅补充 Feed。

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