Petunjuk Migrasi V1 (tidak digunakan lagi) ke V2

Format V1 tidak digunakan lagi. Berikut ini menguraikan perubahan dari feed V1 ke feed V2.3 saat ini. Lihat https://developers.google.com/product-review-feeds/sample/ untuk mengetahui contoh lengkap feed 2.3 terbaru.

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

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

Elemen xmlns:atom dan xmlns:pr telah dihapus. Elemen xmlns:vc telah ditambahkan untuk mereferensikan versi XMLSchema w3.org. Lokasi skema harus diupdate ke 2.3 xsd.

Versi skema

Versi skema kini disertakan setelah header

<version>2.3</version>

Info Penerbit

Bagian info penayang telah dikurangi. Penulis, judul, subtitel, publikasi, hak, id, link, dan logo telah dihapus dan diganti dengan agregator dan penayang serta nama dan ikon penerbit. Elemen agregator tidak wajib untuk feed penjual tunggal.

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

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

Grup Ulasan

Sebelumnya, ulasan ditetapkan oleh elemen <entry> yang berulang. Pada feed 2.3, elemen <review> telah menggantikan elemen <entry> dan dikelompokkan dalam elemen induk <reviews>.

Versi 1

<entry>
...
</entry>

Versi 2.3

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

Tinjau Info

Bagian konten ulasan telah disederhanakan secara dramatis. Untuk mencapai penyederhanaan ini, kolom berikut telah diubah:

Info Ringkasan:

  • <id> sekarang menjadi <review_id>
  • <published> sekarang menjadi <review_timestamp>
  • <pr:content_format> telah dihapus
  • <link> sekarang menjadi <review_url>

Versi 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"/>

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

Info Pengarang:

  • <author> sekarang menjadi <reviewer>
    • <name> sekarang mendukung atribut is_anonymous
    • <reviewer_id> telah ditambahkan
    • <email>, <pr:role>, <pr:number_of_reviews>, dan <link> telah dihapus
    • <pr:author_rating> sekarang adalah <ratings> dan disertakan di luar elemen penulis
      • <pr:attr name=”overall”> sekarang menjadi <overall>. Atribut value sekarang menjadi konten elemen.
      • Elemen <pr:attr> tambahan telah dihapus
  • Atribut full_length <content> telah dihapus
  • Atribut jenis <title> telah dihapus

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

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

Info Konten:

  • Atribut <content> full_length telah dihapus
  • Elemen <video> dan turunannya telah dihapus
  • Elemen induk <reviewer_images> dan elemen turunan <reviewer_image> telah ditambahkan.
    • Elemen <reviewer_image> berisi elemen <url> untuk lokasi gambar

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

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

Info Produk:

  • <pr:products> dengan elemen turunan <pr:product> kini <products> dengan turunan <product>
  • Elemen <pr:product_id> dengan atribut contenttype kini menjadi elemen <product_id> dengan elemen jenis konten sebagai turunan (<gtins>, <mpns>, <skus>)
  • <pr:brand> sekarang menjadi elemen turunan di bawah <product_id>
  • <pr:product_name> sekarang menjadi <product_name>
  • <pr:product_category> elemen telah dihapus
  • <link> sekarang menjadi <product_url>
  • Elemen <pr:number_of_reviews> telah dihapus
  • <pr:average_rating> dan semua elemen turunan telah dihapus

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

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

Info Rating:

  • Elemen <pr:pros> kini menjadi elemen <pros> dengan elemen <pro> turunan
  • Elemen <pr:cons> kini menjadi elemen <cons> dengan elemen <con> turunan
  • <pr:awards> dan semua elemen turunan telah dihapus
  • Elemen <pr:overview> telah dihapus
  • Elemen <pr:ratings> untuk rating atribut individual telah dihapus

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

Versi 2.3

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

Info Tambahan:

  • Elemen <pr:custom> dan elemen turunannya telah dihapus
  • Elemen <pr:related_products> dan elemen turunannya telah dihapus
  • Elemen <is_spam> telah ditambahkan
  • Elemen <collection_method> telah ditambahkan
  • Elemen <transaction_id> telah ditambahkan

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

Versi 2.3

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

Ulasan yang Dihapus

Spesifikasi feed ulasan tidak lagi mendukung atribut hapus. Untuk menghapus ulasan, hapus ulasan dari feed Anda. Setiap ulasan yang dikirimkan sebelumnya, yang tidak disertakan dalam feed Anda berikutnya, akan dihapus.

Versi 1

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

Versi 2

Tidak lagi didukung di Versi 2. Hapus ulasan dengan tidak menyertakannya di feed berikutnya.