Lược đồ XML

Phần này mô tả giản đồ 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:chuỗi	Bắt buộc (1)	Vui lòng mã cứng giá trị sau: http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi	xs:chuỗi	Bắt buộc (1)	Vui lòng mã cứng giá trị sau: http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation	xs:chuỗi	Bắt buộc (1)	Vui lòng mã cứng giá trị sau, để lại một khoảng trống 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 cho 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)	Thành phần lặp lại cho từng người bán.

<merchant>

Mô tả

Mỗi phần tử <merchant> đều 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 nguồn cấp dữ liệu hôm nay và nguồn cấp dữ liệu cách đây 90 đề cập đến cùng một người bán, thì các nguồn cấp dữ liệu đó phải có cùng mã.

Ví dụ:

<merchant id="2739">

Chứa

Vui lòng thêm những phần tử sau đây vào phần tử người bán này.

Tên	Định dạng	Số lần xuất hiện	Mô tả
name	Chuỗi trống (NonEmptyString)	Bắt buộc (1)	Tên hiển thị mà người bán có thể đọc được.
merchant_url	xs:mọi nơi	Bắt buộc (1)	URL đến trang web chính của người bán. Không sử dụng URL chuyển hướng cho giá trị này. Nói cách khác, giá trị đó 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:mọi nơi	Bắt buộc (1)	URL đến trang đích lưu trữ bài đánh giá cho người bán này. Đừng 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)	Ngày/giờ tạo người bán. Thông tin này sẽ không bao giờ thay đổi.
last_update_timestamp	DateTimeWithTimeZone	Bắt buộc (1)	Ngày/ngày cập nhật cho người bán. 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 dành cho những người bán đã bị xóa.

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ị xóa.

<deleted_merchant>

Mô tả

Người bán đã bị xóa.

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 người bán cần xóa khỏi nguồn cấp dữ liệu. Mã này phải khớp với thuộc tính id của phần tử <merchant> trong mọi tệp nguồn cấp dữ liệu 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)	Ngày/giờ mà người bán bị xóa 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 cho 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)	Thành phần lặp lại cho mỗi bài đánh giá.

<review>

Mô tả

Vùng chứa thông tin chi tiết về 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 của 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 có bài đánh giá này.

Chứa

Vui lòng thêm những yếu tố sau đây vào phần tử đánh giá.

Tên	Định dạng	Số lần xuất hiện	Mô tả
reviewer_name	Chuỗi trống (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à tác giả phải có tên của bài đánh giá. Bài đánh giá ẩn danh không được bao gồm trường này. Ví dụ: <reviewer_name> Joel </reviewer_name>
create_timestamp	DateTimeWithTimeZone	Bắt buộc (1)	Ngày/giờ mà người dùng gửi bài đánh giá. Thông tin này sẽ không bao giờ thay đổi. Ví dụ: <create_timestamp> 2016-04-03T18:37:32Z </create_timestamp>
last_update_timestamp	DateTimeWithTimeZone	Bắt buộc (1)	Ngày/giờ thay đổi gần nhất của thông tin trong phần tử <review>. Nếu bạn cập nhật bất kỳ trường nào trong phần tử <review> của một mã 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	Mã quốc gia	Bắt buộc (1)	Quốc gia của người đánh giá. Nếu có, đây là quốc gia nơi sản phẩm được vận chuyển đến hoặc nơi cung cấp dịch vụ. Nếu không, hãy sử dụng thông tin về 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 ở định dạng ISO 3166-1 alpha-2. Ví dụ: <country_code> US </country_code>
title	xs:chuỗi	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 túy, không có bất kỳ thẻ HTML nào. Ví dụ: <title> Great prices </title>
content	xs:chuỗi	Bắt buộc (1)	Nội dung của bài đánh giá. Đây phải là bất kỳ văn bản dạng tự do nào do người dùng cung cấp và không được cắt ngắn. Nội dung phải là văn bản thuần tuý mà không có thẻ HTML. Ví dụ: ngắt dòng phải được thể hiện bằng ký tự nguồn cấp dữ liệu dòng, không phải bằng thẻ <br>. Nếu bạn cung cấp nhiều câu trả lời cho nhiều câu hỏi, thì tất cả câu trả lời phải được đưa vào, kèm theo ngữ cảnh tối thiểu để giúp người dùng hiểu rõ các câu trả lời. Bạn không nên cung cấp ngữ cảnh nếu không trả lời câu hỏ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)	Thành phần vùng chứa cho xếp hạng của người đánh giá của người bán. Nếu không có điểm xếp hạng cho phần tử <overall>, thì bạn phải loại trừ toàn bộ bài đánh giá có 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ó bài đánh giá đó.
collection_method	CollectionMethodType	Bắt buộc (1)	Phương thứ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 mong muốn: Người dùng không phản hồi một lời mời chào cụ thể khi họ gửi bài đánh giá. Point_of_sale: Người dùng gửi bài đánh giá để đáp lại một lời mời chào khi người dùng đặt hàng. sau_fulfillment: Người dùng gửi bài đánh giá để đáp lại một lời mời chào sau khi thực hiện đơn đặt hàng của người dùng. Ví dụ: <collection_method> after_fulfillment </collection_method>

<ratings>

Mô tả

Chứa xếp hạng của người đánh giá đối với người bán. Nếu không có điểm xếp hạng cho phần tử <overall>, thì bạn phải loại trừ toàn bộ bài đánh giá có 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ó bài đánh giá đó.

Chứa

Vui lòng thêm các thành phần sau đây vào thành phần xếp hạng.

Tên	Định dạng	Số lần xuất hiện	Mô tả
overall	Điểm xếp hạng	Bắt buộc (1)	Điểm xếp hạng chung của người đánh giá đối với người bán. Ví dụ: <overall min="1" max="10">9</overall>
customer_service	Điểm xếp hạng	Không bắt buộc (0‐1)	Đánh giá 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 cho các bài đánh giá đã bị xóa.

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) thành phần liên quan đến một bài đánh giá bị xóa.

<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)	Xác định mã của một bài đánh giá cần bị xoá khỏi nguồn cấp dữ liệu. Mã này phải khớp với thuộc tính mã nhận dạng của phần tử <review> trong mọi tệp nguồn cấp dữ liệu.

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 mà một bài đánh giá bị xóa 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>