XML 架构参考

Google 商品评价 Feed 的 XML 架构定义了 XML Feed 的可接受结构。XML 架构使用 .xsd 文件扩展名。与 DTD 文件一样，XML 架构定义了 XML 文档中可以出现的元素和属性。

您可以从这篇 XML 架构入门指南中详细了解 XML 架构。

商品评价 Feed 的 XML 架构已在此处发布： http://www.google.com/shopping/reviews/schema/product/2.4/product_reviews.xsd

下面将介绍此架构定义的 Feed 结构。在此说明中，带有前缀 xs: 的类型名称是指 XML 命名空间 http://www.w3.org/2001/XMLSchema 中的内置 XML 架构类型。

我们的系统始终需要完整 Feed。之前提交但未包含在您的下一个完整 Feed 中的任何评价都将被删除。因此，您在提交 Feed 时应始终提交所有评价。

顶级 <feed> 元素

<feed> 元素包含以下元素，且顺序与所列顺序相同。

元素 出现次数 类型 说明
<version> 必需 (1) xs:string 指明正在使用的商品评价 Feed 架构的版本。目前仅支持 <version>2.4</version>。
<aggregator> 可选 (1) aggregatorType 发布者可以使用评价聚合信息网站来管理评价并提供 Feed。此元素表示使用聚合器，并包含有关聚合器的信息。
<publisher> 必需 (1) publisherType 发布商的相关信息，发布商可以是零售商、制造商、评价服务公司或发布商品评价的任何实体。
<reviews> 可选 (1) xs:sequence 包含商品评价。

<feed> 用于定义 Feed 中所用元素的唯一性限制条件。

子元素

<aggregator>

发布商可以使用评价集合商家来管理评价并提供 Feed。此元素表示使用了聚合器，并包含有关聚合器的信息。<aggregator> 元素包含这些元素，且顺序与所列顺序一致。

元素 出现次数 类型 说明
<name> 必需 (1) nonEmptyStringType 商品评价的汇总商的名称。

<publisher>

有关发布者的信息，发布者可以是零售商、制造商、评价服务公司或发布商品评价的任何实体。<publisher> 元素按所列顺序包含以下元素。

元素 出现次数 类型 说明
<name> 必需 (1) nonEmptyStringType 商品评价的发布者的名称。
<favicon> 可选 (1) httpUrlType 指向发布商公司网站图标的链接。图片尺寸应为 favicon 大小：16x16 像素。图片格式应为 GIF、JPG 或 PNG。

<reviews>

包含商品评价。<reviews> 元素包含以下元素，并按所列顺序排列。

元素 出现次数 类型 说明
<review> 必需 （1-无限） reviewType 单个唯一商品评价。如果评价涉及发布商资源目录中的多件商品，请指定一次评价，并在 <products> 元素中添加多个 <product> 元素。

<review>

单个唯一商品评价。如果评价涉及发布商商品目录中的多件商品，请指定一次评价，并在 <products> 元素中添加多个 <product> 元素。<review> 元素按所列顺序包含这些元素。

元素 出现次数 类型 说明
<review_id> 必需 (1) nonEmptyStringType 发布商系统中商品评价的永久唯一标识符。
<reviewer> 必需 (1) reviewerType 商品评价的作者。
<is_verified_purchase> 可选 (1) xs:boolean 指明是否已验证评价者购买了相应商品。
<is_incentivized_review> 可选 (1) xs:boolean 指明评价者是否因评价商品而获得奖励。
<review_timestamp> 必需 (1) xs:dateTime

指示撰写评价时的时间戳。

示例：

2014-04-21T11:07:07-06:00
2014-04-21T18:00:00+01:00
2014-04-21T00:00:00Z
<title> 可选 (1) nonEmptyStringType 评价的标题。
<content> 必需 (1) nonEmptyStringType 评价的内容。
<review_language> 可选 (1) xs:string 评价的语言 (BCP 47)。
<review_country> 可选 (1) xs:string 评价者的国家/地区代码 (ISO 3166-1)。
<pros> 可选 (1) xs:sequence 包含根据评价者的意见得出的优点。省略“优点：”等样板文字，除非这些文字是由评价者撰写的。
<cons> 可选 (1) xs:sequence 包含根据评价者的意见得出的缺点。省略样板文字，例如“缺点：”，除非是评价者撰写的。
<reviewer_images> 可选 (1) xs:sequence 包含评价者提供的商品图片链接。
<review_url> 必需 (1) reviewUrlType 评价着陆页的网址。
<ratings> 必需 (1) xs:sequence 包含与评价相关联的评分。
<products> 必需 (1) xs:sequence 包含与评价关联的商品。
<is_spam> 可选 (1) xs:boolean 表示相应评价是否在发布商的系统中被标记为垃圾评价。
<collection_method> 可选 (1) collectionMethodType

用于收集评价的方法。该值必须是以下值之一：

unsolicited
用户并非因为回应邀请而提交评价。
post_fulfillment
用户在订单完成履单后，应邀请提交评价。
<transaction_id> 可选 (1) nonEmptyStringType 发布商系统中与评价关联的交易的永久唯一标识符。此 ID 可用于指明多条评价与同一交易相关联。

<reviewer>

商品评价的作者。<reviewer> 元素包含以下元素，并按所列顺序排列。

元素 出现次数 类型 说明
<name> 必需 (1) reviewerNameType

评价作者的姓名。

示例：

<name>Jane</name>
<reviewer_id> 可选 (1) nonEmptyStringType

发布商系统中评价作者的永久唯一标识符。

示例：

<reviewer_id>14295</reviewer_id>

<name>

评价作者的姓名。<name> 元素是 nonEmptyStringType 的扩展，包含评价者的姓名或别名。<name> 元素包含以下属性。

属性 出现次数 类型 说明
is_anonymous 可选 xs:boolean

指明评价者是否匿名。

示例：

<name is_anonymous="true">Anonymous</name>

<pros>

包含根据评价者的意见得出的优点。<pros> 元素包含以下元素，并按所列顺序排列。

元素 出现次数 类型 说明
<pro> 必需 （1-无限） nonEmptyStringType

根据评价者的意见，单个优点。优点应按照显示顺序列出。省略“优点：”等样板文字，除非这些文字是由评价者撰写的。

示例：

<pros>
  <pro>Sleek design</pro>
</pros>

<cons>

包含根据评价者的意见得出的缺点。<cons> 元素包含以下元素，并按所列顺序排列。

元素 出现次数 类型 说明
<con> 必需 （1-无限） nonEmptyStringType

根据评价者的意见得出的个人缺点。缺点应按显示顺序列出。省略“缺点：”等样板文字，除非这些文字是由评价者撰写的。

示例：

<cons>
  <con>Pricey</con>
</cons>

<review_url>

评价着陆页的网址。<review_url> 元素是 httpUrlType 的扩展，包含指向评价着陆页的链接。<review_url> 元素包含以下属性。

属性 出现次数 类型 说明
type 必需 xs:string

类型必须是以下类型之一：

singleton
评价页面仅包含这一条评价。
group
评价页面包含一组评价，其中包括此评价。

示例：

<review_url type="singleton">http://www.example.com/review_5.html</review_url>

<reviewer_images>

包含评价者提供的商品图片。<reviewer_images> 标记包含多个 <reviewer_image> 元素。

元素 出现次数 类型 说明
<reviewer_image> 必需 （1-无限） reviewImageType

评价作者创建的被评价商品的图片。

<reviewer_image>

单个评价图片元素。

元素 出现次数 类型 说明
<url> 必需 (1) httpUrlType

评价作者创建的被评价商品的图片网址。网址不必以图片文件扩展名结尾。

示例：

<reviewer_images>
  <reviewer_image>
    <url>https://example.com/test.jpg</url>
  </reviewer_image>
  <reviewer_image>
    <url>https://example.com/test.gif</url>
  </reviewer_image>
</reviewer_images>

<ratings>

包含与评价相关联的评分。<ratings> 元素包含以下元素，并按所列顺序排列。

元素 出现次数 类型 说明
<overall> 必需 (1) ratingType 评价者对产品的总体评分。

<overall>

评价者对产品的总体评分。<overall> 元素扩展了 xs:decimal simpleType，并捕获评价者分配的评分。该值应在 min 和 max 属性定义的包含性范围内。<overall> 元素包含以下属性。

属性 出现次数 类型 说明
min 必需 xs:integer 评分的最小值。这应该是可能的最差评分，不应是无评分的值。
max 必需 xs:integer 评分的最大可能值。max 属性的值必须大于 min 属性的值。

<products>

包含与评价相关联的商品。<products> 元素包含以下元素，并按所列顺序排列。

元素 出现次数 类型 说明
<product> 必需 （1-无限） productType 与评价关联的商品。

<product>

与评价关联的商品。<product> 元素包含以下元素，并按所列顺序排列。

元素 出现次数 类型 说明
<product_ids> 可选 (1) productIdsType 与商品相关联的标识符。
<product_name> 可选 (1) nonEmptyStringType 商品的描述性名称。
<product_url> 必需 (1) httpUrlType 商品的网址。如果评价网址与商品网址相同，此网址的值可以与 <review_url> 元素的值相同。

<product_ids>

与商品相关联的标识符。<product_ids> 元素包含以下元素，并按所列顺序排列。

元素 出现次数 类型 说明
<gtins> 必需属性（对于与具有已知 GTIN 的商品相关联的所有评价）

对于所有其他评价，此属性为可选属性(1)		 gtinsType 包含与商品相关联的 GTIN（全球贸易项目代码）。系统支持 GTIN 的子类型（例如 UPC、EAN、ISBN、JAN）。
<mpns> 必需属性（对于与具有已知 MPN 的商品相关联的所有评价）

对于所有其他评价，此属性为可选属性(1)		 mpnsType 包含与商品关联的 MPN（制造商部件号）。
<skus> 必需（对于与具有已知 SKU 的商品相关联的所有评价）

对于所有其他评价，此属性为可选属性(1)		 skusType 包含与商品关联的 SKU（库存量单位）。此值通常与商品 Feed 中的商品优惠 ID 一致。
<brands> 必需属性（对于与已知品牌商品相关联的所有评价）

对于所有其他评价，此属性为可选属性 (1)		 brandsType 包含与商品相关联的品牌名称。
<asins> 可选 (1) asinsType 包含与商品关联的 ASIN（亚马逊标准识别号）。

<gtins>

包含与商品相关联的 GTIN（全球贸易项目代码）。<gtins> 元素包含以下元素，且顺序与所列顺序相同。

元素 出现次数 类型 说明
<gtin> 必需 （1-无限） nonEmptyStringType 商品的全球贸易项目代码。系统支持 GTIN 的子类型（例如 UPC、EAN、ISBN、JAN）。

<mpns>

包含与商品关联的 MPN（制造商部件号）。<mpns> 元素包含以下元素，且顺序与所列顺序相同。

元素 出现次数 类型 说明
<mpn> 必需 （1-无限） nonEmptyStringType 商品的制造商部件号。

<skus>

包含与商品关联的 SKU（库存量单位）。<skus> 元素包含以下元素，并按所列顺序排列。

元素 出现次数 类型 说明
<sku> 必需 （1-无限） nonEmptyStringType 出版商商品目录中商品的库存单元。

<brands>

包含与商品相关联的品牌名称。<brands> 元素包含以下元素，并按所列顺序排列。

元素 出现次数 类型 说明
<brand> 必需 （1-无限） nonEmptyStringType 商品的品牌名称。

<asins>

包含与商品关联的 ASIN（亚马逊标准识别号）。<asins> 元素包含以下元素，且顺序与所列顺序相同。

元素 出现次数 类型 说明
<asin> 必需 （1-无限） nonEmptyStringType 商品的亚马逊标准识别号。每个 ASIN 的长度为 10 个字符，并且包含字母数字。