Hướng dẫn di chuyển phiên bản 1 (không dùng nữa) sang phiên bản 2

Định dạng phiên bản 1 đã ngừng hoạt động. Phần sau đây trình bày các thay đổi từ nguồn cấp dữ liệu V1 cho nguồn cấp dữ liệu phiên bản 2.3 hiện tại. Vui lòng xem https://developers.google.com/product-review-feeds/sample/ để xem ví dụ đầy đủ về nguồn cấp dữ liệu 2.3 mới nhất.

Phiên bản 1

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns:atom="http://www.w3.org/2005/Atom" xml:lang="en-US"
   xmlns:pr="http://schemas.google.com/schemas/pr/1.0"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://www.gstatic.com/productsearch/static/reviews/product_reviews_v1.xsd”>

Phiên bản 2.3

<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:noNamespaceSchemaLocation=
 "http://www.google.com/shopping/reviews/schema/product/2.3/product_reviews.xsd">

Các phần tử xmlns:atomxmlns:pr đã bị xóa. Phần tử xmlns:vc đã được thêm để tham chiếu phiên bản XML w3.org. Bạn nên cập nhật vị trí giản đồ thành 2.3 xsd.

Phiên bản giản đồ

Phiên bản giản đồ hiện được đưa vào sau tiêu đề

<version>2.3</version>

Thông tin về nhà xuất bản

Phần thông tin về nhà xuất bản đã được giảm bớt. Tác giả, tiêu đề, tiêu đề phụ, đã xuất bản, quyền, id, liên kết và biểu trưng đã bị xóa để thay thế cho đơn vị tập hợp và nhà xuất bản có tên và biểu tượng của nhà xuất bản. Phần tử tổng hợp là không bắt buộc đối với nguồn cấp dữ liệu người bán đơn lẻ.

Phiên bản 1

 <author>
    <name>Sample Retailer</name>
    <email>contact@example.com</email>
  </author>
  <title type="text">Product Reviews from Example.com </title>
  <subtitle type="text">Camera Reviews - Example.com </subtitle>
  <published>2007-12-10T15:13:31Z</published>
  <rights>Copyright 2008, all rights reserved.</rights>
  <id>12345678</id>
  <link rel="related" type="text/html" href="http://www.example.com/index.html"/>
  <logo>http://www.example.com/logo.jpg</logo>

Phiên bản 2.3

    <aggregator>
        <name>Sample Reviews Aggregator (if applicable)</name>
    </aggregator>
    <publisher>
        <name>Sample Retailer</name>
        <favicon>http://www.example.com/favicon.png</favicon>
    </publisher>

Xem lại nhóm

Trước đây, bài đánh giá được chỉ định bằng các phần tử <entry> lặp lại. Trong nguồn cấp dữ liệu 2.3, các phần tử <review> đã thay thế các phần tử <entry> và được nhóm trong một phần tử mẹ <reviews>.

Phiên bản 1

<entry>
...
</entry>

Phiên bản 2.3

    <reviews>
        <review>
...
        </review>
    </reviews>

Xem lại thông tin

Chúng tôi đã đơn giản hóa phần nội dung đánh giá. Để đạt được sự đơn giản hóa này, chúng tôi đã sửa đổi các trường sau:

Thông tin tóm tắt:

  • <id> đổi tên thành <review_id>
  • <published> đổi tên thành <review_timestamp>
  • Đã xoá <pr:content_format>
  • <link> đổi tên thành <review_url>

Phiên bản 1

    <id>14295</id>
    <published>2014-04-21T07:07:07Z</published>
    <title type="text">Excellent camera</title>
    <pr:content_format type="user_review"/>
    <link rel="self" type="text/html" href="http://www.example.com/review_14295.html"/>

Phiên bản 2.3

      <review_id>14295</review_id>
        ...
      <review_timestamp>2014-04-21T07:07:07Z</review_timestamp>
      <title>Excellent camera</title>
        ...
      <review_url type="singleton">http://www.example.com/review_14295.html</review_url>

Thông tin tác giả:

  • <author> hiện là <reviewer>
    • <name> hiện hỗ trợ thuộc tính is_anonymous
    • Đã thêm <reviewer_id>
    • <email>, <pr:role>, <pr:number_of_reviews><link> đã bị xóa
    • <pr:author_rating> hiện là <ratings> và được đưa vào bên ngoài phần tử tác giả
      • <pr:attr name=”overall”> đổi tên thành <overall> Thuộc tính value hiện là nội dung của phần tử.
      • Các phần tử <pr:attr> bổ sung đã bị xóa
  • Đã xóa thuộc tính <content> [full_length]
  • Đã xóa thuộc tính loại <title>

Phiên bản 1

   <author>
      <name>Joe Smith</name>
      <email>jsmith@example.com</email>
      <pr:role>Consumer Electronics Editor</pr:role>
      <pr:number_of_reviews>45</pr:number_of_reviews>
      <link rel="related" href="http://www.example.com."/>
      <pr:author_rating>
        <pr:attr name="overall" max="5" min="1" value="4"></pr:attr>
        <pr:attr name="funny"></pr:attr>
      </pr:author_rating>
    </author>

Phiên bản 2.3

        <reviewer>
            <name is_anonymous="false">Joe Smith</name>
            <reviewer_id>509769</reviewer_id>
        </reviewer>
        ...
        <ratings>
            <overall min="1" max="5">4</overall>
        </ratings>

Thông tin nội dung:

  • Thuộc tính <content> full_length đã bị xóa
  • Phần tử <video> và các phần tử con đã bị xóa
  • Đã thêm phần tử mẹ <reviewer_images><reviewer_image> phần tử con.
    • Các phần tử <reviewer_image> chứa phần tử <url> cho vị trí hình ảnh

Phiên bản 1

   <content full_length="3083">
      Got it for a friend and he loved it.
   </content>
    <video>
      <published>2008-07-31T04:13:31Z</published>
      <title type="text">Digital Cameras in Action</title>
      <link rel="related" href="http://www.youtube.com/watch?v=SdybCjJ5sCU"/>
      <summary>Expert photog Jill Thompson takes the Canon XTi on the road</summary>
    </video>

Phiên bản 2.3

   <content>Got it for a friend and he loved it.</content>
    ...
   <review_url type="singleton">http://www.example.com/review_14295.html</review_url>
   <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>

Thông tin sản phẩm:

  • <pr:products><pr:product> phần tử con hiện là <products><product> phần tử con
  • Các phần tử <pr:product_id> có thuộc tính contenttype hiện là các phần tử <product_id> có các phần tử loại nội dung dành cho trẻ em (<gtins>, <mpns>, <skus>)
  • <pr:brand> hiện là một phần tử con trong <product_id>
  • <pr:product_name> đổi tên thành <product_name>
  • Đã xóa <pr:product_category> thành phần
  • <link> đổi tên thành <product_url>
  • Đã xóa phần tử <pr:number_of_reviews>
  • <pr:average_rating> và tất cả thành phần con đã bị xóa

Phiên bản 1

   <pr:products>
      <pr:product>
        <pr:product_id contenttype="MPN">60101-10000</pr:product_id>
        <pr:product_id contenttype="UPC">888884</pr:product_id>
        <pr:product_id contenttype="base_docid">9876543</pr:product_id>
        <pr:brand>Acme</pr:brand>
        <pr:product_name>Tablet Sleeve</pr:product_name>
        <pr:product_category level="1" category_id="123423">Consumer Electronics</pr:product_category>
        <pr:product_category level="2" category_id="123423">Tablets</pr:product_category>
        <pr:product_category level="3" category_id="123423">Cases</pr:product_category>
        <link rel="canonical" type="text/html" href="http://www.example.com/product_6206.html"/>
        <link rel="related" type="image/jpg" href="http://reviews.example.com/..."/>
        <link rel="related" type="text/html" href="http://reviews.example.com/..."/>
        <pr:number_of_reviews>5</pr:number_of_reviews>
        <pr:average_rating>
          <pr:attr name="overall" max="5" min="1" value="3.4"></pr:attr>
          <pr:attr name="durability" max="5" min="1" value="3.7"></pr:attr>
          <pr:attr name="ease_of_use" max="5" min="1" value="3.2"></pr:attr>
        </pr:average_rating>
      </pr:product>
 </pr:products>

Phiên bản 2.3

    <products>
        <product>
            <product_ids>
                <gtins>
                    <gtin>541710238425</gtin>
                </gtins>
                <mpns>
                    <mpn>60101-10000</mpn>
                </mpns>
                <skus>
                    <sku>6206</sku>
                </skus>
                <brands>
                    <brand>Acme</brand>
                </brands>
            </product_ids>
            <product_name>Tablet Sleeve</product_name>
            <product_url>http://www.example.com/product_6206.html</product_url>
        </product>
    </products>

Thông tin phân loại:

  • Các phần tử <pr:pros> hiện là <pros> phần tử có các phần tử con <pro>
  • Các phần tử <pr:cons> hiện là <cons> phần tử có các phần tử con <con>
  • <pr:awards> và tất cả thành phần con đã bị xóa
  • Đã xóa phần tử <pr:overview>
  • Đã xóa <pr:ratings> phần tử cho từng điểm xếp hạng thuộc tính

Phiên bản 1

    <pr:pros>Sleek design</pr:pros>
    <pr:pros>Protects the tablet well</pr:pros>
    <pr:cons>Pricey</pr:cons>
    <pr:overview> Best for well lit spaces, outdoor shots...</pr:overview>
    <pr:awards>
      <pr:award>
        <pr:award_name>CBest Camera Award </pr:award_name>
        <link rel="related" type="image/jpg" href="http://www.example.com/..."/>
      </pr:award>
    </pr:awards>
    ...
    <pr:ratings>
      <pr:attr name="overall" max="5" min="1" value="3"></pr:attr>
      <pr:attr name="durability" max="5" min="1" value="3"></pr:attr>
      <pr:attr name="ease_of_use" max="5" min="1" value="3"></pr:attr>
    </pr:ratings>

Phiên bản 2.3

    <pros>
        <pro>Sleek design</pro>
        <pro>Protects the tablet well</pro>
    </pros>
    <cons>
        <con>Pricey</con>
    </cons>

Thông tin bổ sung:

  • Các phần tử <pr:custom> và phần tử con của các phần tử đó đã bị xóa
  • Các phần tử <pr:related_products> và phần tử con của các phần tử đó đã bị xóa
  • Đã thêm phần tử <is_spam>
  • Đã thêm phần tử <collection_method>
  • Đã thêm phần tử <transaction_id>

Phiên bản 1

   <pr:custom>
      <pr:custom_title>
        Recall Information
      </pr:custom_title>
      <pr:custom_description>
        The batteries used with this camera are known to...
      </pr:custom_description>
       </pr:custom>
   ...
   <pr:related_products>
      <pr:related_product relate="complementary">
        <pr:product_id contenttype="MPN">5454545454</pr:product_id>
        <pr:product_id contenttype="UPC">4444456</pr:product_id>
        <pr:product_id contenttype="base_docid">9876500</pr:product_id>
        <pr:brand>Tamron</pr:brand>
        <pr:product_name>Tamron Telephoto Zoom Lens</pr:product_name>
        <pr:product_category level="1" category_id="123423">Consumer Electronics</pr:product_category>
          <pr:product_category level="2" category_id="123423">Digital Camera</pr:product_category>
            <pr:product_category level="3" category_id="123423">Digital SLR
              Accessories</pr:product_category
            <link rel="canonical" type="text/html" href="http://reviews.example.com/digital-cameras/tamron/id=2345670.html"/>
            <link rel="related" type="text/html" href="http://www.tamron.com."/>
            <link rel="related" type="text/html" href="http://reviews.example.com/digital-cameras/tamron/..."/>
      </pr:related_product>

Phiên bản 2.3

      <is_spam>false</is_spam>
      <collection_method>post_fulfillment</collection_method>
      <transaction_id>fulfillment_transaction_11198373</transaction_id>

Bài đánh giá đã xóa

Thông số nguồn cấp dữ liệu đánh giá không còn hỗ trợ thuộc tính xóa. Để xóa các bài đánh giá, hãy bỏ qua các bài đánh giá đó khỏi nguồn cấp dữ liệu. Mọi bài đánh giá đã gửi trước đây không có trong nguồn cấp dữ liệu tiếp theo đều sẽ bị xóa.

Phiên bản 1

  <deleted_entry>
    <id>34567</id>
  </deleted_entry>

Phiên bản 2

Không còn được hỗ trợ trong Phiên bản 2. Xóa các bài đánh giá bằng cách không đưa các bài đánh giá đó vào nguồn cấp dữ liệu tiếp theo.