Tham chiếu lược đồ XML

Sách: /product-review-feeds/_book.yaml

Tiêu đề: Tham chiếu lược đồ XML

Giản đồ XML cho Nguồn cấp dữ liệu đá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ư các tệp DTD, giản đồ 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ề lược đồ XML từ Tài liệu về giản đồ XML này.

Bạn có thể xuất bản giản đồ XML cho nguồn cấp dữ liệu đánh giá sản phẩm tại đây: http://www.google.com/shopping/Reviews/schema/product/2.3/product_Reviews.xsd

Phần mô tả cấu trúc nguồn cấp dữ liệu được xác định theo giản đồ này sẽ theo sau. Trong phần mô tả này, tên loại có tiền tố xs: là các loại giản đồ XML tích hợp sẵn nằm trong không gian tên XML http://www.w3.org/2001/XMLSchema.

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

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

Thành phần <feed> chứa các thành phần này theo thứ tự liệt kê.

Phần tử Lần xuất hiện Loại Nội dung mô tả
<version> Bắt buộc (1) xs:string Cho biết phiên bản của giản đồ nguồn cấp dữ liệu đánh giá sản phẩm đang được sử dụng. Tại thời điểm này, hệ thống chỉ hỗ trợ <version>2.3</version>.
<aggregator> Không bắt buộc (1) aggregatorType Nhà xuất bản có thể sử dụng trình tổng hợp 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 phát hành 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 hạn chế về tính duy nhất trên các phần tử dùng trong nguồn cấp dữ liệu.

Thành phần con

<aggregator>

Nhà xuất bản có thể sử dụng trang web tổng hợp các bài đánh giá để quản lý 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ự liệt kê.

Phần tử Lần xuất hiện Loại Nội dung mô tả
<name> Bắt buộc (1) nonEmptyStringType Tên của đơn vị tập 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 có thể xuất bản bài đánh giá sản phẩm.Phần tử <publisher> chứa các thành phần này theo thứ tự liệt kê.

Phần tử Lần xuất hiện Loại Nội dung mô tả
<name> Bắt buộc (1) nonEmptyStringType Tên nhà xuất bản của 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 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ự liệt kê.

Phần tử Lần xuất hiện Loại Nội dung mô tả
<review> Bắt buộc (1 không giới hạn) reviewType Một bài đánh giá sản phẩm riêng lẻ. Nếu một bài đánh giá liên quan đến nhiều sản phẩm trong khoảng không quảng cáo 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á sản phẩm riêng lẻ. Nếu một bài đánh giá liên quan đến nhiều sản phẩm trong khoảng không quảng cáo 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ự liệt kê.

Phần tử Lần xuất hiện Loại Nội dung mô tả
<review_id> Không bắt buộc (1) nonEmptyStringType Giá trị nhận dạng vĩnh viễn, duy nhất cho 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ả bài đánh giá sản phẩm.
<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á.
<pros> Không bắt buộc (1) xs:sequence Chứa các chuyên gia dựa trên ý kiến của người đánh giá. Bỏ qua văn bản tạo sẵn như "pro:" trừ khi người đánh giá viết.
<cons> Không bắt buộc (1) xs:sequence Chứa các nhược điểm dựa trên ý kiến của người đánh giá. Bỏ qua văn bản tạo sẵn như "con:" trừ khi 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 của 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 đánh giá.
<ratings> Bắt buộc (1) xs:sequence Chứa các xếp hạng được 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 được liên kết với bài đánh giá.
<is_spam> Không bắt buộc (1) xs:boolean Cho biết bài đánh giá có bị đánh dấu là nội dung vi phạm 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 những giá trị sau:

unsolicited
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á.
post_fulfillment
Người dùng đã gửi bài đánh giá để đáp lại một hành vi gạ gẫm sau khi thực hiện đơn đặt hàng của người dùng.
<transaction_id> Không bắt buộc (1) nonEmptyStringType Giá trị nhận dạng vĩnh viễn, duy nhất cho giao dịch liên kết với bài đánh giá trong hệ thống của nhà xuất bản. Mã này có thể dùng để cho biết rằng nhiều bài đánh giá sẽ được liên kết với cùng một giao dịch.

<reviewer>

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

Phần tử Lần xuất hiện Loại Nội dung 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 vĩnh viễn, duy nhất cho 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 này.

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

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

Ví dụ:

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

<pros>

Chứa các chuyên gia 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ự liệt kê.

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

Chuyên gia cá nhân dựa trên ý kiến của người đánh giá. Bạn phải liệt kê các chuyên gia theo đúng thứ tự xuất hiện. Bỏ qua văn bản tạo sẵn như "pro:" trừ khi người đánh giá viết.

Ví dụ:

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

<cons>

Chứa các nhược điểm 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ự liệt kê.

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

Nội dung chia sẻ của một cá nhân dựa trên quan điểm của người đánh giá. Bạn phải liệt kê các nhược điểm theo đúng thứ tự xuất hiện. Bỏ qua văn bản tạo sẵn như "con:" trừ khi người đánh giá viết.

Ví dụ:

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

<review_url>

URL của trang đích đá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á. Thành phần <review_url> chứa các thuộc tính này.

Thuộc tính Lần xuất hiện Loại Nội dung 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á này.
group
Trang đánh giá chứa một nhóm các bài đánh giá, bao gồm 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 Nội dung mô tả
<reviewer_image> Bắt buộc (1 không giới hạn) reviewImageType

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

<reviewer_image>

Một phần tử hình ảnh đánh giá duy nhất.

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

URL đến hình ảnh của sản phẩm được đánh giá do tác giả bài đánh giá tạo ra. URL không bắt buộc 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 các xếp hạng được 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ự liệt kê.

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

<overall>

Điểm xếp hạng chung của người đánh giá 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ị này phải nằm trong phạm vi bao hàm được xác định bằng các thuộc tính min và max. Thành phần <overall> chứa các thuộc tính này.

Thuộc tính Lần xuất hiện Loại Nội dung mô tả
min Bắt buộc xs:integer Số lượng tối thiểu có thể dùng để xếp hạng. Đây phải là mức phân loại thấp nhất có thể và không được là giá trị không có điểm xếp hạng.
max Bắt buộc xs:integer Số lượng tối đa có thể 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 được liên kết với bài đánh giá. Phần tử <products> chứa các phần tử này theo thứ tự liệt kê.

Phần tử Lần xuất hiện Loại Nội dung 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ự liệt kê.

Phần tử Lần xuất hiện Loại Nội dung mô tả
<product_ids> Không bắt buộc (1) productIdsType Giá trị nhận dạng 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 thành phần <review_url>, nếu URL bài đánh giá và URL sản phẩm giống nhau.

<product_ids>

Giá trị nhận dạng 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ự liệt kê.

Phần tử Lần xuất hiện Loại Nội dung mô tả
<gtins> Bắt buộc (Đối với tất cả các bài đánh giá được liên kết với những sản phẩm có GTIN (Mã số sản phẩm thương mại toàn cầu) đã biết để có thể so khớp toàn bộ bài đánh giá)

Không bắt buộc (rất nên dùng) đối với tất cả cá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) liên kết với một sản phẩm.
<mpns> Bắt buộc (cần bao gồm MPN để hỗ trợ quá trình so khớp bài đánh giá nếu sản phẩm được liên kết với bài đánh giá không có GTIN được chỉ định). Phải được gửi cùng với Thương hiệu)

Không bắt buộc đối với tất cả các bài đánh giá khác (1)		 mpnsType Chứa MPN (số bộ phận của nhà sản xuất) liên kết với một sản phẩm.
<skus> Bắt buộc (phải bao gồm SKU để hỗ trợ việc so khớp bài đánh giá nếu sản phẩm được liên kết với bài đánh giá không có GTIN hoặc MPN được chỉ định). Nên được gửi cùng với Thương hiệu)

Không bắt buộc đối với tất cả các bài đánh giá khác (1)		 skusType Chứa SKU (đơn vị lưu kho) liên kết với một sản phẩm. Thông thường, mã nhận dạng này khớp với Mã ưu đãi sản phẩm trong nguồn cấp dữ liệu sản phẩm.
<brands> Bắt buộc (Bạn nên thêm thương hiệu để hỗ trợ việc so khớp bài đánh giá nếu sản phẩm được liên kết với bài đánh giá không có GTIN được chỉ định). Phải gửi bằng MPN)

Không bắt buộc đối với tất cả cá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 (Số nhận dạng tiêu chuẩn của Amazon) 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) 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ự liệt kê.

Phần tử Lần xuất hiện Loại Nội dung 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.

<mpns>

Chứa MPN (số bộ phận của nhà sản xuất) 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ự liệt kê.

Phần tử Lần xuất hiện Loại Nội dung 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) 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ự liệt kê.

Phần tử Lần xuất hiện Loại Nội dung 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ảng không quảng cáo 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ự liệt kê.

Phần tử Lần xuất hiện Loại Nội dung 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 (Số nhận dạng tiêu chuẩn của Amazon) liên kết với một sản phẩm. Phần tử chứa các phần tử này theo thứ tự liệt kê.

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