Lược đồ XML

Phần này mô tả lược đồ XML được dùng cho nguồn cấp dữ liệu bài đánh giá người bán.

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

Mô tả

Phần tử vùng chứa trên cùng chứa tất cả các phần tử khác trong nguồn cấp dữ liệu.

Thuộc tính

Tên	Định dạng	Số lần xuất hiện	Mô tả
xmlns	xs:string	Bắt buộc (1)	Vui lòng mã hoá cứng giá trị sau: http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi	xs:string	Bắt buộc (1)	Vui lòng mã hoá cứng giá trị sau: http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation	xs:string	Bắt buộc (1)	Vui lòng mã hoá cứng giá trị sau, để lại một dấu cách giữa các URL: http://schemas.google.com/merchant_reviews/5.0 http://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd

Ví dụ:

<feed xmlns="http://schemas.google.com/merchant_reviews/5.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://schemas.google.com/merchant_reviews/5.0 https://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd">

Chứa

Tên	Định dạng	Số lần xuất hiện	Mô tả
merchants	--	Không bắt buộc (0-1)	Phần tử vùng chứa cho các phần tử <merchant>.
deleted_merchants	--	Không bắt buộc (0-1)	Phần tử vùng chứa cho các phần tử <deleted_merchant>.
reviews	--	Không bắt buộc (0-1)	Phần tử vùng chứa cho các phần tử <review>.
deleted_reviews	--	Không bắt buộc (0-1)	Phần tử vùng chứa cho các phần tử <deleted_review>.

<merchants>

Mô tả

Vùng chứa các phần tử <merchant>.

Chứa

Tên	Định dạng	Số lần xuất hiện	Mô tả
merchant	--	Bắt buộc (1 – n)	Phần tử lặp lại cho từng người bán.

<merchant>

Mô tả

Mỗi phần tử <merchant> chứa thông tin và bài đánh giá cho một người bán.

Thuộc tính

Tên	Định dạng	Số lần xuất hiện	Mô tả
id	Mã nhận dạng	Bắt buộc (1)	Phải là duy nhất và ổn định trên tất cả các nguồn cấp dữ liệu. Nói cách khác, nếu một nguồn cấp dữ liệu hôm nay và một nguồn cấp dữ liệu cách đây 90 ngày đề cập đến cùng một người bán, thì chúng phải có cùng mã nhận dạng.

Ví dụ:

<merchant id="2739">

Chứa

Vui lòng thêm các phần tử sau vào phần tử người bán.

Tên	Định dạng	Số lần xuất hiện	Mô tả
name	NonEmptyString	Bắt buộc (1)	Tên hiển thị dễ đọc của người bán.
merchant_url	xs:anyURI	Bắt buộc (1)	URL của trang web chính của người bán. Đừng sử dụng URL chuyển hướng cho giá trị này. Nói cách khác, giá trị này phải trỏ trực tiếp đến trang web của người bán. Ví dụ: <merchant_url> http://store.google.com </merchant_url>
rating_url	xs:anyURI	Bắt buộc (1)	URL dẫn đến trang đích lưu trữ các bài đánh giá cho người bán này. Không sử dụng URL chuyển hướng. Ví dụ: <rating_url> http://merchant_url.com/reviews/ </rating_url>
create_timestamp	DateTimeWithTimeZone	Bắt buộc (1)	Thời gian/ngày tạo người bán. Thông tin này không được thay đổi.
last_update_timestamp	DateTimeWithTimeZone	Bắt buộc (1)	Thời gian/ngày mà người bán được cập nhật gần đây nhất. Nếu bạn cập nhật bất kỳ trường nào trong phần tử <merchant> cho một mã người bán nhất định, thì giá trị này cũng phải thay đổi.

<deleted_merchants>

Mô tả

Vùng chứa cho những người bán đã bị xoá.

Chứa

Tên	Định dạng	Số lần xuất hiện	Mô tả
deleted_merchant	--	Bắt buộc (1 – n)	Chứa(các) phần tử liên quan đến một người bán đã bị xoá.

<deleted_merchant>

Mô tả

Người bán đã bị xoá.

Thuộc tính

Tên	Định dạng	Số lần xuất hiện	Mô tả
id	Mã nhận dạng	Bắt buộc (1)	Chỉ định mã nhận dạng của một người bán cần xoá khỏi nguồn cấp dữ liệu. Mã nhận dạng này phải khớp với thuộc tính id của một phần tử <merchant> trong bất kỳ tệp nguồn cấp dữ liệu nào trước đó.

Chứa

Tên	Định dạng	Số lần xuất hiện	Mô tả
last_update_timestamp	DateTimeWithTimeZone	Bắt buộc (1)	Thời gian/ngày mà người bán bị xoá khỏi hệ thống. Ví dụ: <last_update_timestamp> 2016-04-03T18:37:32Z </last_update_timestamp>

Ví dụ:

<deleted_merchant id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z</last_update_timestamp>
</deleted_merchant>

<reviews>

Mô tả

Vùng chứa các phần tử <review>.

Chứa

Tên	Định dạng	Số lần xuất hiện	Mô tả
review	--	Bắt buộc (1 – n)	Phần tử được lặp lại cho từng bài đánh giá.

<review>

Mô tả

Vùng chứa thông tin chi tiết liên quan đến một bài đánh giá.

Thuộc tính

Tên	Định dạng	Số lần xuất hiện	Mô tả
id	Mã nhận dạng	Bắt buộc (1)	Giá trị nhận dạng cho một bài đánh giá trong hệ thống của bạn. Phải là duy nhất và ổn định trên tất cả các nguồn cấp dữ liệu. Ví dụ: <review id=132739 mid=1234>
mid	Mã nhận dạng	Bắt buộc (1)	Giá trị nhận dạng của người bán mà bài đánh giá này dành cho.

Chứa

Vui lòng thêm các phần tử sau vào phần tử bài đánh giá.

Tên	Định dạng	Số lần xuất hiện	Mô tả
reviewer_name	NonEmptyString	Không bắt buộc (0-1)	Tên hiển thị của tác giả bài đánh giá, miễn là bài đánh giá phải có tên tác giả. Bài đánh giá ẩn danh không được có trường này. Ví dụ: <reviewer_name> Joel </reviewer_name>
create_timestamp	DateTimeWithTimeZone	Bắt buộc (1)	Ngày/giờ người dùng gửi bài đánh giá. Thông tin này không được thay đổi. Ví dụ: <create_timestamp> 2016-04-03T18:37:32Z </create_timestamp>
last_update_timestamp	DateTimeWithTimeZone	Bắt buộc (1)	Thời gian/ngày thông tin trong phần tử <review> thay đổi lần gần đây nhất. Nếu bạn cập nhật bất kỳ trường nào trong phần tử <review> cho một mã nhận dạng bài đánh giá nhất định, thì giá trị này cũng phải thay đổi. Ví dụ: <last_update_timestamp> 2016-04-03T18:37:32Z </last_update_timestamp>
country_code	CountryCode	Bắt buộc (1)	Quốc gia của người đánh giá. Nếu có, đây là quốc gia mà bạn vận chuyển sản phẩm đến hoặc nơi cung cấp dịch vụ. Nếu không, hãy sử dụng quốc gia của người đánh giá tại thời điểm tạo bài đánh giá. Mã quốc gia phải theo định dạng ISO 3166-1 alpha-2. Ví dụ: <country_code> US </country_code>
title	xs:string	Không bắt buộc (0-1)	Tiêu đề của bài đánh giá. Tiêu đề phải là văn bản thuần tuý, không có thẻ HTML nào trong đó. Ví dụ: <title> Great prices </title>
content	xs:string	Bắt buộc (1)	Nội dung của bài đánh giá. Đây phải là văn bản tự do do người dùng cung cấp và không được cắt bớt. Nội dung phải là văn bản thuần tuý, không có thẻ HTML nào trong đó. Ví dụ: dấu ngắt dòng phải được biểu thị bằng ký tự dòng mới, chứ không phải thẻ <br>. Nếu bạn cung cấp nhiều câu trả lời cho các câu hỏi khác nhau, thì bạn phải đưa ra tất cả câu trả lời, kèm theo bối cảnh tối thiểu để các câu trả lời có ý nghĩa. Bạn không nên cung cấp bối cảnh nếu câu hỏi chưa được trả lời. Ví dụ: <content> I like this store! My order arrived on time and I got a great price. </content> Ví dụ: <content> Positives: Great prices. Suggestions: Selection could be better. </content>
ratings	--	Bắt buộc (1)	Phần tử vùng chứa cho điểm xếp hạng của người đánh giá về người bán. Nếu không có điểm xếp hạng cho phần tử <overall>, thì bạn nên loại trừ toàn bộ bài đánh giá liên quan khỏi nguồn cấp dữ liệu vì phần tử <overall> là bắt buộc và bài đánh giá sẽ không được chấp nhận nếu không có phần tử này.
collection_method	CollectionMethodType	Bắt buộc (1)	Phương thức được dùng để thu thập bài đánh giá. Giá trị phải là một trong những giá trị sau: không được yêu cầu: Người dùng không phản hồi một yêu cầu cụ thể khi gửi bài đánh giá. point_of_sale: Người dùng gửi bài đánh giá để đáp lại một yêu cầu khi họ đặt hàng. after_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. Ví dụ: <collection_method> after_fulfillment </collection_method>

<ratings>

Mô tả

Chứa điểm xếp hạng của người đánh giá về người bán. Nếu không có điểm xếp hạng cho phần tử <overall>, thì bạn nên loại trừ toàn bộ bài đánh giá liên quan khỏi nguồn cấp dữ liệu vì phần tử <overall> là bắt buộc và bài đánh giá sẽ không được chấp nhận nếu không có phần tử này.

Chứa

Vui lòng thêm các phần tử sau vào phần tử xếp hạng.

Tên	Định dạng	Số lần xuất hiện	Mô tả
overall	RatingRange	Bắt buộc (1)	Điểm xếp hạng tổng thể của người đánh giá dành cho người bán. Ví dụ: <overall min="1" max="10">9</overall>
customer_service	RatingRange	Không bắt buộc (0-1)	Điểm xếp hạng của người đánh giá về chất lượng dịch vụ khách hàng của người bán này. Ví dụ: <customer_service min="1" max="5">3</customer_service>

<deleted_reviews>

Mô tả

Vùng chứa các bài đánh giá đã bị xoá.

Chứa

Tên	Định dạng	Số lần xuất hiện	Mô tả
deleted_review	--	Bắt buộc (1 – n)	Chứa(các) phần tử liên quan đến một bài đánh giá đã bị xoá.

<deleted_review>

Mô tả

Bài đánh giá đã bị xoá.

Thuộc tính

Tên	Định dạng	Số lần xuất hiện	Mô tả
id	Mã nhận dạng	Bắt buộc (1)	Chỉ định mã nhận dạng của một bài đánh giá cần bị xoá khỏi nguồn cấp dữ liệu. Mã nhận dạng này phải khớp với thuộc tính id của một phần tử <review> trong bất kỳ tệp nguồn cấp dữ liệu nào.

Chứa

Tên	Định dạng	Số lần xuất hiện	Mô tả
last_update_timestamp	DateTimeWithTimeZone	Bắt buộc (1)	Thời điểm một bài đánh giá bị xoá khỏi hệ thống. Ví dụ: <last_update_timestamp> 2016-04-03T18:37:32Z </last_update_timestamp>

Ví dụ:

<deleted_review id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z<last_update_timestamp>
</deleted_review>