Instructions de migration V1 (obsolète) vers V2

Le format V1 est obsolète. Vous trouverez ci-dessous les modifications du flux V1 vers le flux V2.3 actuel. Veuillez consulter la page https://developers.google.com/product-review-feeds/sample/ pour obtenir un exemple complet du dernier flux (2.3).

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

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

Les éléments xmlns:atom et xmlns:pr ont été supprimés. Un élément xmlns:vc a été ajouté pour référencer la version-XML w3.org. L'emplacement du schéma doit être mis à jour vers la version 2.3 xsd.

Version du schéma

La version du schéma est désormais incluse après l'en-tête.

<version>2.3</version>

Informations sur l'éditeur

La section "Informations sur l'éditeur" a été réduite. L'auteur, le titre, le sous-titre, le droit, l'identifiant, le lien et le logo ont été supprimés en faveur d'un agrégateur et de l'éditeur qui possède le nom et l'icône de l'éditeur. L'élément agrégateur n'est pas nécessaire pour les flux de marchand unique.

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

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

Examiner le groupe

Auparavant, les avis étaient désignés par des éléments <entry> répétés. Dans le flux 2.3, les éléments <review> ont remplacé les éléments <entry> et sont regroupés sous un élément parent <reviews>.

Version 1

<entry>
...
</entry>

Version 2.3

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

Consulter les informations

La section du contenu des avis a été considérablement simplifiée. Pour plus de simplicité, les champs suivants ont été modifiés:

Récapitulatif:

  • "<id>" est désormais "<review_id>".
  • "<published>" est désormais "<review_timestamp>".
  • L'appareil "<pr:content_format>" a été supprimé
  • "<link>" est désormais "<review_url>".

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

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

Informations sur l'auteur:

  • <author> devient <reviewer>
    • <name> accepte désormais un attribut is_anonymous
    • <reviewer_id> a été ajouté
    • <email>, <pr:role>, <pr:number_of_reviews> et <link> ont été supprimés
    • <pr:author_rating> est désormais <ratings> et est inclus en dehors de l'élément d'auteur.
      • <pr:attr name=”overall”> est désormais <overall>. L'attribut value est désormais le contenu de l'élément.
      • <pr:attr> éléments supplémentaires ont été supprimés
  • L'attribut <content> (longueur) a été supprimé
  • L'attribut de type <title> a été supprimé

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

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

Informations sur le contenu:

  • L'attribut full_length <content> a été supprimé
  • L'élément <video> et ses enfants ont été supprimés
  • L'élément parent <reviewer_images> et <reviewer_image> éléments enfants ont été ajoutés.
    • Les éléments <reviewer_image> contiennent un élément <url> pour l'emplacement de l'image

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

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

Informations sur le produit:

  • <pr:products> avec <pr:product> éléments enfants sont désormais <products> avec <product> enfants
  • Les éléments <pr:product_id> avec des attributs contenttype sont désormais des éléments <product_id> avec des éléments de type de contenu comme enfants (<gtins>, <mpns>, <skus>)
  • <pr:brand> est maintenant un élément enfant de <product_id>
  • "<pr:product_name>" est désormais "<product_name>".
  • <pr:product_category> éléments ont été supprimés
  • "<link>" est désormais "<product_url>".
  • <pr:number_of_reviews> élément a été supprimé
  • <pr:average_rating> et tous les éléments enfants ont été supprimés

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

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

Informations sur la note:

  • Les éléments <pr:pros> sont maintenant <pros> éléments avec des éléments enfants <pro>
  • Les éléments <pr:cons> sont maintenant <cons> éléments avec des éléments enfants <con>
  • <pr:awards> et tous les éléments enfants ont été supprimés
  • <pr:overview> élément a été supprimé
  • <pr:ratings> éléments pour les attributs d'attribut individuels ont été supprimés

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

Version 2.3

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

Informations supplémentaires:

  • <pr:custom> éléments et leurs éléments enfants ont été supprimés
  • <pr:related_products> éléments et leurs éléments enfants ont été supprimés
  • <is_spam> élément a été ajouté
  • <collection_method> élément a été ajouté
  • <transaction_id> élément a été ajouté

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

Version 2.3

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

Avis supprimés

La spécification du flux d'avis n'est plus compatible avec un attribut de suppression. Pour supprimer des avis, omettez-les de votre flux. Tous les avis précédemment envoyés qui ne figurent pas dans votre prochain flux seront supprimés.

Version 1

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

Version 2

N'est plus compatible avec la version 2. Supprimez les avis en les excluant dans le flux suivant.