Istruzioni per la migrazione da V1 (deprecata) a V2

Il formato V1 è deprecato. Di seguito sono descritte le modifiche apportate dal feed V1 all'attuale feed V2.3. Per un esempio completo del feed 2.3 più recente, consulta la pagina https://developers.google.com/product-review-feeds/sample/.

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

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

Gli elementi xmlns:atom e xmlns:pr sono stati rimossi. È stato aggiunto un elemento xmlns:vc che fa riferimento al controllo della versione XMLSchema w3.org. La posizione dello schema deve essere aggiornata alla 2.3 xsd.

Versione schema

La versione dello schema viene ora inclusa dopo l'intestazione

<version>2.3</version>

Informazioni sul publisher

La sezione delle informazioni sul publisher è stata ridotta. Autore, titolo, sottotitolo, pubblicazioni, diritti, ID, link e logo sono stati rimossi a favore dell'aggregatore e dell'editore con il nome e l'icona dell'editore. L'elemento aggregatore non è richiesto per i singoli feed commerciante.

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

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

Esamina gruppo

In precedenza, le recensioni venivano designate da elementi <entry> ripetuti. Nel feed 2.3, gli elementi <review> hanno sostituito gli elementi <entry> e sono raggruppati sotto un elemento principale <reviews>.

Versione 1

<entry>
...
</entry>

Versione 2.3

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

Informazioni sulla recensione

La sezione dei contenuti della recensione è stata notevolmente semplificata. Per raggiungere questa semplificazione, sono stati modificati i seguenti campi:

Informazioni di riepilogo:

  • <id> ora è <review_id>
  • <published> ora è <review_timestamp>
  • Il dispositivo <pr:content_format> è stato rimosso
  • <link> ora è <review_url>

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

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

Informazioni sull'autore:

  • <author> è diventato <reviewer>
    • Ora <name> supporta un attributo is_anonymous
    • <reviewer_id> è stato aggiunto
    • <email>, <pr:role>, <pr:number_of_reviews> e <link> sono stati rimossi
    • <pr:author_rating> ora è <ratings> ed è incluso al di fuori dell'elemento autore
      • <pr:attr name=”overall”> adesso è <overall>. Ora l'attributo value è il contenuto dell'elemento.
      • Altri elementi <pr:attr> sono stati rimossi
  • L'attributo full_length <content> è stato rimosso
  • L'attributo del tipo <title> è stato rimosso

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

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

Informazioni sui contenuti:

  • L'attributo <content> full_length è stato rimosso
  • L'elemento <video> e le relative unità secondarie sono state rimosse
  • Sono stati aggiunti l'elemento principale <reviewer_images> e gli elementi secondari <reviewer_image>.
    • Gli elementi <reviewer_image> contengono un elemento <url> per la posizione dell'immagine

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

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

Informazioni sul prodotto:

  • Ora <pr:products> con <pr:product> elementi secondari sono <products> con <product> bambini
  • Gli elementi <pr:product_id> con attributi contenttype sono ora elementi <product_id> con elementi di tipo contenuti come secondari (<gtins>, <mpns>, <skus>)
  • Ora <pr:brand> è un elemento secondario in <product_id>
  • <pr:product_name> ora è <product_name>
  • <pr:product_category> elementi sono stati rimossi
  • <link> ora è <product_url>
  • L'elemento <pr:number_of_reviews> è stato rimosso
  • <pr:average_rating> e tutti gli elementi secondari sono stati rimossi

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

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

Informazioni sulla valutazione:

  • Gli elementi <pr:pros> sono ora elementi <pros> con elementi <pro> secondari
  • Gli elementi <pr:cons> sono ora elementi <cons> con elementi <con> secondari
  • <pr:awards> e tutti gli elementi secondari sono stati rimossi
  • L'elemento <pr:overview> è stato rimosso
  • Gli elementi <pr:ratings> per le valutazioni dei singoli attributi sono stati rimossi

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

Versione 2.3

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

Ulteriori informazioni:

  • <pr:custom> elementi e i relativi elementi secondari sono stati rimossi
  • <pr:related_products> elementi e i relativi elementi secondari sono stati rimossi
  • L'elemento <is_spam> è stato aggiunto
  • L'elemento <collection_method> è stato aggiunto
  • L'elemento <transaction_id> è stato aggiunto

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

Versione 2.3

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

Recensioni eliminate

La specifica del feed delle recensioni non supporta più un attributo Elimina. Per eliminarle, omettile dal feed. Le recensioni inviate in precedenza non incluse nel feed successivo verranno eliminate.

Versione 1

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

Versione 2

La versione 2 non è più supportata. Elimina le recensioni non includendole nel feed successivo.