此页面由 Cloud Translation API 翻译。

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

商品说明页面 (PDP) 可以向买家介绍商品的功能和福利。您可以通过 Content API 上传丰富的商品数据，制作内容丰富的 PDP 购物。丰富的商品数据包含与商品功能相关的信息和优势、商品款式/规格以及商品图片。

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

向观众提供更详细的商品说明，让用户更容易发现您的商品帮助客户找到符合其需求的产品
通过提供准确的商品信息来提升客户的信任度能够信心十足地做出购买决定
更清晰地向客户

本指南介绍了在以下情况下，如何使用 Content API 上传丰富的商品数据使用 products.insert 方法。通过以下部分提供了包含属性的部分请求正文（针对 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"

产品名称

提供重要的商品详情，例如品牌、适用性别、尺码和 color [颜色]）在 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 [商品组 ID]：定义。

示例请求

"itemGroupId": "pixels"

产品亮点

商品说明页面上的“商品亮点”部分会显示一个简短的主商品图片旁边的商品详情项目符号列表。使用 productHighlights 属性，用于提供商品的商品列表 “突出显示”部分我们建议您至少提供五个商品亮点。对于有关商品亮点的其他准则和要求，请参阅 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 属性。我们建议至少提供六个商品详情如需了解与商品相关的其他准则和要求，请参阅 product_detail [商品详情]：定义。

示例请求

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

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

Google 使用唯一商品标识码来标识商品。我们强烈建议您提供 GTIN 为每件商品指定不同的价值如果您不提供 GTIN，则必须提供 brand [品牌] 和 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"
}