Tham chiếu lược đồ XML

Lược đồ XML cho nguồn cấp dữ liệu bài đánh giá sản phẩm của Google xác định cấu trúc được chấp nhận của nguồn cấp dữ liệu XML. Lược đồ XML sử dụng đuôi tệp .xsd. Giống như tệp DTD, lược đồ XML xác định các phần tử và thuộc tính có thể xuất hiện trong tài liệu XML.

Bạn có thể tìm hiểu thêm về giản đồ XML trong Hướng dẫn cơ bản về giản đồ XML này.

Lược đồ XML cho nguồn cấp dữ liệu bài đánh giá sản phẩm được đăng tại đây: http://www.google.com/shopping/reviews/schema/product/2.4/product_reviews.xsd

Sau đây là nội dung mô tả về cấu trúc nguồn cấp dữ liệu do giản đồ này xác định. Trong phần mô tả này, tên loại có tiền tố xs: đề cập đến các loại lược đồ XML tích hợp trong không gian tên XML http://www.w3.org/2001/XMLSchema.

Hệ thống của chúng tôi luôn yêu cầu một nguồn cấp dữ liệu đầy đủ. Mọi bài đánh giá đã gửi trước đây nhưng không có trong nguồn cấp dữ liệu đầy đủ tiếp theo của bạn sẽ bị xoá. Do đó, bạn phải luôn gửi tất cả bài đánh giá khi gửi nguồn cấp dữ liệu.

Phần tử <feed> cấp cao nhất

Phần tử <feed> chứa các phần tử này theo thứ tự được liệt kê.

Phần tử Lần xuất hiện Loại Mô tả
<version> Bắt buộc (1) xs:string Cho biết phiên bản nào của giản đồ nguồn cấp dữ liệu đánh giá sản phẩm đang được sử dụng. Hiện tại, chúng tôi chỉ hỗ trợ <version>2.4</version>.
<aggregator> Không bắt buộc (1) aggregatorType Nhà xuất bản có thể sử dụng một đơn vị tổng hợp các bài đánh giá để quản lý các bài đánh giá và cung cấp nguồn cấp dữ liệu. Phần tử này cho biết việc sử dụng một trang web tổng hợp và chứa thông tin về trang web tổng hợp đó.
<publisher> Bắt buộc (1) publisherType Thông tin về nhà xuất bản, có thể là nhà bán lẻ, nhà sản xuất, công ty dịch vụ đánh giá hoặc bất kỳ pháp nhân nào xuất bản bài đánh giá sản phẩm.
<reviews> Không bắt buộc (1) xs:sequence Chứa các bài đánh giá sản phẩm.

<feed> xác định các ràng buộc về tính duy nhất đối với các phần tử được dùng trong nguồn cấp dữ liệu.

Phần tử con

<aggregator>

Nhà xuất bản có thể sử dụng một đơn vị tập hợp các bài đánh giá để quản lý các bài đánh giá và cung cấp nguồn cấp dữ liệu. Phần tử này cho biết việc sử dụng một trang web tổng hợp và chứa thông tin về trang web tổng hợp đó. Phần tử <aggregator> chứa các phần tử này theo thứ tự được liệt kê.

Phần tử Lần xuất hiện Loại Mô tả
<name> Bắt buộc (1) nonEmptyStringType Tên của đơn vị tổng hợp các bài đánh giá sản phẩm.

<publisher>

Thông tin về nhà xuất bản, có thể là nhà bán lẻ, nhà sản xuất, công ty dịch vụ đánh giá hoặc bất kỳ pháp nhân nào xuất bản bài đánh giá sản phẩm.Phần tử <publisher> chứa các phần tử này theo thứ tự được liệt kê.

Phần tử Lần xuất hiện Loại Mô tả
<name> Bắt buộc (1) nonEmptyStringType Tên của nhà xuất bản bài đánh giá sản phẩm.
<favicon> Không bắt buộc (1) httpUrlType Đường liên kết đến biểu tượng trang web của công ty nhà xuất bản. Kích thước hình ảnh phải là kích thước biểu tượng trang web: 16x16 pixel. Hình ảnh phải ở định dạng GIF, JPG hoặc PNG.

<reviews>

Chứa các bài đánh giá sản phẩm. Phần tử <reviews> chứa các phần tử này theo thứ tự được liệt kê.

Phần tử Lần xuất hiện Loại Mô tả
<review> Bắt buộc (1 – không giới hạn) reviewType Một bài đánh giá riêng biệt và duy nhất về sản phẩm. Nếu một bài đánh giá liên quan đến nhiều sản phẩm trong kho hàng của nhà xuất bản, hãy chỉ định bài đánh giá một lần và thêm nhiều phần tử <product> vào phần tử <products>.

<review>

Một bài đánh giá riêng biệt và duy nhất về sản phẩm. Nếu một bài đánh giá liên quan đến nhiều sản phẩm trong kho hàng của nhà xuất bản, hãy chỉ định bài đánh giá một lần và thêm nhiều phần tử <product> vào phần tử <products>.Phần tử <review> chứa các phần tử này theo thứ tự được liệt kê.

Phần tử Lần xuất hiện Loại Mô tả
<review_id> Bắt buộc (1) nonEmptyStringType Giá trị nhận dạng riêng biệt, cố định của bài đánh giá sản phẩm trong hệ thống của nhà xuất bản.
<reviewer> Bắt buộc (1) reviewerType Tác giả của bài đánh giá sản phẩm.
<is_verified_purchase> Không bắt buộc (1) xs:boolean Cho biết liệu có xác minh được rằng người đánh giá đã mua sản phẩm hay không.
<is_incentivized_review> Không bắt buộc (1) xs:boolean Cho biết người đánh giá có được khuyến khích để đánh giá sản phẩm hay không.
<review_timestamp> Bắt buộc (1) xs:dateTime

Dấu thời gian cho biết thời điểm viết bài đánh giá.

Ví dụ:

2014-04-21T11:07:07-06:00
2014-04-21T18:00:00+01:00
2014-04-21T00:00:00Z
<title> Không bắt buộc (1) nonEmptyStringType Tiêu đề của bài đánh giá.
<content> Bắt buộc (1) nonEmptyStringType Nội dung của bài đánh giá.
<review_language> Không bắt buộc (1) xs:string Ngôn ngữ của bài đánh giá (BCP 47).
<review_country> Không bắt buộc (1) xs:string Mã quốc gia (ISO 3166-1) của người đánh giá.
<pros> Không bắt buộc (1) xs:sequence Chứa những điểm tích cực dựa trên ý kiến của người đánh giá. Bỏ qua văn bản tạo sẵn như "ưu điểm:" trừ phi người đánh giá đã viết văn bản đó.
<cons> Không bắt buộc (1) xs:sequence Chứa các điểm hạn chế dựa trên ý kiến của người đánh giá. Bỏ qua văn bản chung như "con:" trừ phi văn bản đó do người đánh giá viết.
<reviewer_images> Không bắt buộc (1) xs:sequence Chứa đường liên kết đến hình ảnh sản phẩm do người đánh giá cung cấp.
<review_url> Bắt buộc (1) reviewUrlType URL của trang đích có bài đánh giá.
<ratings> Bắt buộc (1) xs:sequence Chứa điểm xếp hạng liên kết với bài đánh giá.
<products> Bắt buộc (1) xs:sequence Chứa các sản phẩm liên quan đến bài đánh giá.
<is_spam> Không bắt buộc (1) xs:boolean Cho biết liệu bài đánh giá có bị đánh dấu là nội dung rác trong hệ thống của nhà xuất bản hay không.
<collection_method> Không bắt buộc (1) collectionMethodType

Phương thức dùng để thu thập bài đánh giá. Giá trị phải là một trong các giá trị sau:

unsolicited
Người dùng không phản hồi một yêu cầu cụ thể khi họ gửi bài đánh giá.
post_fulfillment
Người dùng gửi bài đánh giá để đáp lại một yêu cầu sau khi đơn đặt hàng của họ được thực hiện.
<transaction_id> Không bắt buộc (1) nonEmptyStringType Giá trị nhận dạng riêng biệt, cố định của giao dịch được liên kết với bài đánh giá trong hệ thống của nhà xuất bản. Bạn có thể dùng mã này để cho biết rằng nhiều bài đánh giá được liên kết với cùng một giao dịch.

<reviewer>

Tác giả của bài đánh giá sản phẩm. Phần tử <reviewer> chứa các phần tử này theo thứ tự được liệt kê.

Phần tử Lần xuất hiện Loại Mô tả
<name> Bắt buộc (1) reviewerNameType

Tên của tác giả bài đánh giá.

Ví dụ:

<name>Jane</name>
<reviewer_id> Không bắt buộc (1) nonEmptyStringType

Giá trị nhận dạng riêng biệt, cố định của tác giả bài đánh giá trong hệ thống của nhà xuất bản.

Ví dụ:

<reviewer_id>14295</reviewer_id>

<name>

Tên của tác giả bài đánh giá. Phần tử <name> là phần mở rộng của nonEmptyStringType và chứa tên hoặc bí danh của người đánh giá. Phần tử <name> chứa các thuộc tính sau.

Thuộc tính Lần xuất hiện Loại Mô tả
is_anonymous Không bắt buộc xs:boolean

Cho biết liệu người đánh giá có ẩn danh hay không.

Ví dụ:

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

<pros>

Chứa những điểm tích cực dựa trên ý kiến của người đánh giá. Phần tử <pros> chứa các phần tử này theo thứ tự được liệt kê.

Phần tử Lần xuất hiện Loại Mô tả
<pro> Bắt buộc (1 – không giới hạn) nonEmptyStringType

Một ưu điểm riêng lẻ dựa trên ý kiến của người đánh giá. Bạn nên liệt kê các ưu điểm theo thứ tự xuất hiện. Bỏ qua văn bản tạo sẵn như "ưu điểm:" trừ phi văn bản đó do người đánh giá viết.

Ví dụ:

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

<cons>

Chứa các điểm hạn chế dựa trên ý kiến của người đánh giá. Phần tử <cons> chứa các phần tử này theo thứ tự được liệt kê.

Phần tử Lần xuất hiện Loại Mô tả
<con> Bắt buộc (1 – không giới hạn) nonEmptyStringType

Một điểm bất lợi riêng lẻ dựa trên ý kiến của người đánh giá. Bạn nên liệt kê các nhược điểm theo thứ tự xuất hiện. Bỏ qua văn bản tạo sẵn như "nhược điểm:" trừ phi văn bản đó do người đánh giá viết.

Ví dụ:

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

<review_url>

URL của trang đích có bài đánh giá. Phần tử <review_url> là phần mở rộng của httpUrlType và chứa đường liên kết đến trang đích của bài đánh giá. Phần tử <review_url> chứa các thuộc tính sau.

Thuộc tính Lần xuất hiện Loại Mô tả
type Bắt buộc xs:string

Loại phải là một trong những loại sau:

singleton
Trang đánh giá chỉ chứa bài đánh giá duy nhất này.
group
Trang bài đánh giá có một nhóm bài đánh giá, trong đó có bài đánh giá này.

Ví dụ:

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

<reviewer_images>

Chứa hình ảnh về sản phẩm do người đánh giá cung cấp. Thẻ <reviewer_images> chứa nhiều phần tử <reviewer_image>.

Phần tử Lần xuất hiện Loại Mô tả
<reviewer_image> Bắt buộc (1 – không giới hạn) reviewImageType

Hình ảnh về sản phẩm được đánh giá do tác giả bài đánh giá tạo.

<reviewer_image>

Một phần tử hình ảnh của bài đánh giá.

Phần tử Lần xuất hiện Loại Mô tả
<url> Bắt buộc (1) httpUrlType

URL đến một hình ảnh về sản phẩm được đánh giá do tác giả bài đánh giá tạo ra. URL không nhất thiết phải kết thúc bằng đuôi tệp hình ảnh.

Ví dụ:

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

Chứa điểm xếp hạng liên kết với bài đánh giá. Phần tử <ratings> chứa các phần tử này theo thứ tự được liệt kê.

Phần tử Lần xuất hiện Loại Mô tả
<overall> Bắt buộc (1) ratingType Điểm xếp hạng tổng thể của người đánh giá về sản phẩm.

<overall>

Điểm xếp hạng tổng thể của người đánh giá về sản phẩm. Phần tử <overall> mở rộng xs:decimal simpleType và ghi lại điểm xếp hạng do người đánh giá chỉ định. Giá trị phải nằm trong phạm vi bao gồm được xác định bằng các thuộc tính min và max. Phần tử <overall> chứa các thuộc tính sau.

Thuộc tính Lần xuất hiện Loại Mô tả
min Bắt buộc xs:integer Số lượng tối thiểu có thể cho điểm xếp hạng. Đây phải là điểm xếp hạng kém nhất có thể và không được là giá trị cho trường hợp không có điểm xếp hạng.
max Bắt buộc xs:integer Số lượng tối đa có thể cho điểm xếp hạng. Giá trị của thuộc tính max phải lớn hơn giá trị của thuộc tính min.

<products>

Chứa các sản phẩm liên quan đến bài đánh giá. Phần tử <products> chứa các phần tử này theo thứ tự được liệt kê.

Phần tử Lần xuất hiện Loại Mô tả
<product> Bắt buộc (1 – không giới hạn) productType Một sản phẩm được liên kết với bài đánh giá.

<product>

Một sản phẩm được liên kết với bài đánh giá. Phần tử <product> chứa các phần tử này theo thứ tự được liệt kê.

Phần tử Lần xuất hiện Loại Mô tả
<product_ids> Không bắt buộc (1) productIdsType Mã nhận dạng được liên kết với một sản phẩm.
<product_name> Không bắt buộc (1) nonEmptyStringType Tên mô tả của một sản phẩm.
<product_url> Bắt buộc (1) httpUrlType URL của sản phẩm. URL này có thể có cùng giá trị với phần tử <review_url> nếu URL bài đánh giá và URL sản phẩm giống nhau.

<product_ids>

Mã nhận dạng được liên kết với một sản phẩm. Phần tử <product_ids> chứa các phần tử này theo thứ tự được liệt kê.

Phần tử Lần xuất hiện Loại Mô tả
<gtins> Bắt buộc (Đối với tất cả bài đánh giá liên quan đến sản phẩm có GTIN đã biết)

Không bắt buộc đối với tất cả bài đánh giá khác (1)		 gtinsType Chứa GTIN (mã số sản phẩm thương mại toàn cầu) được liên kết với một sản phẩm. Chúng tôi hỗ trợ các loại phụ của GTIN (ví dụ: UPC, EAN, ISBN, JAN).
<mpns> Bắt buộc (Đối với tất cả bài đánh giá liên quan đến sản phẩm có MPN đã biết)

Không bắt buộc đối với tất cả bài đánh giá khác (1)		 mpnsType Chứa MPN (mã số linh kiện của nhà sản xuất) được liên kết với một sản phẩm.
<skus> Bắt buộc (Đối với tất cả bài đánh giá liên quan đến sản phẩm có SKU đã biết)

Không bắt buộc đối với tất cả bài đánh giá khác (1)		 skusType Chứa SKU (đơn vị lưu kho) được liên kết với một sản phẩm. Giá trị này thường khớp với Mã ưu đãi của sản phẩm trong nguồn cấp dữ liệu sản phẩm.
<brands> Bắt buộc (Đối với tất cả bài đánh giá liên quan đến sản phẩm có Thương hiệu đã biết)

Không bắt buộc đối với tất cả bài đánh giá khác (1)		 brandsType Chứa tên thương hiệu liên kết với một sản phẩm.
<asins> Không bắt buộc (1) asinsType Chứa ASIN (Mã nhận dạng chuẩn của Amazon) được liên kết với một sản phẩm.

<gtins>

Chứa GTIN (mã số sản phẩm thương mại toàn cầu) được liên kết với một sản phẩm. Phần tử <gtins> chứa các phần tử này theo thứ tự được liệt kê.

Phần tử Lần xuất hiện Loại Mô tả
<gtin> Bắt buộc (1 – không giới hạn) nonEmptyStringType Mã số sản phẩm thương mại toàn cầu của sản phẩm. Chúng tôi hỗ trợ các loại phụ của GTIN (ví dụ: UPC, EAN, ISBN, JAN).

<mpns>

Chứa MPN (mã số linh kiện của nhà sản xuất) được liên kết với một sản phẩm. Phần tử <mpns> chứa các phần tử này theo thứ tự được liệt kê.

Phần tử Lần xuất hiện Loại Mô tả
<mpn> Bắt buộc (1 – không giới hạn) nonEmptyStringType Mã số linh kiện của nhà sản xuất sản phẩm.

<skus>

Chứa SKU (đơn vị lưu kho) được liên kết với một sản phẩm. Phần tử <skus> chứa các phần tử này theo thứ tự được liệt kê.

Phần tử Lần xuất hiện Loại Mô tả
<sku> Bắt buộc (1 – không giới hạn) nonEmptyStringType Đơn vị lưu kho của sản phẩm trong kho hàng của nhà xuất bản.

<brands>

Chứa tên thương hiệu liên kết với một sản phẩm. Phần tử <brands> chứa các phần tử này theo thứ tự được liệt kê.

Phần tử Lần xuất hiện Loại Mô tả
<brand> Bắt buộc (1 – không giới hạn) nonEmptyStringType Tên thương hiệu của sản phẩm.

<asins>

Chứa ASIN (Mã nhận dạng chuẩn của Amazon) được liên kết với một sản phẩm. Phần tử <asins> chứa các phần tử này theo thứ tự được liệt kê.

Phần tử Lần xuất hiện Loại Mô tả
<asin> Bắt buộc (1 – không giới hạn) nonEmptyStringType Mã nhận dạng tiêu chuẩn của Amazon cho sản phẩm. Mỗi ASIN có độ dài 10 ký tự và là ký tự chữ và số.