Instrucciones de migración de V1 (obsoleta) a V2

El formato V1 es obsoleto. A continuación, se describen los cambios del feed V1 al feed V2.3 actual. Visita https://developers.google.com/product-review-feeds/sample/ para ver un ejemplo completo del feed 2.3 más reciente.

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

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

Se quitaron los elementos xmlns:atom y xmlns:pr. Se agregó un elemento xmlns:vc para hacer referencia al control de versiones XMLSchema.org de w3.org. La ubicación del esquema debe actualizarse a 2.3 xsd.

Versión del esquema

La versión del esquema ahora se incluye después del encabezado

<version>2.3</version>

Información del publicador

Se redujo la sección de información del publicador. Se quitaron el autor, el título, el subtítulo, los derechos, el ID, el vínculo y el logotipo publicados en favor del agregador y el editor con el ícono y el nombre del publicador. El elemento agregador no es obligatorio para los feeds de un solo comercio.

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

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

Grupo de opiniones

Anteriormente, las opiniones se designaban mediante elementos <entry> repetidos. En el feed 2.3, los elementos <review> reemplazaron a los elementos <entry> y se agrupan en un elemento superior <reviews>.

Versión 1

<entry>
...
</entry>

Versión 2.3

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

Revisar información

La sección de contenido de las opiniones se simplificó de forma significativa. Para lograr esta simplificación, se modificaron los siguientes campos:

Información resumida:

  • <id> ahora es <review_id>.
  • <published> ahora es <review_timestamp>.
  • Se quitó <pr:content_format>.
  • <link> ahora es <review_url>.

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

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

Información del autor:

  • <author> ahora es <reviewer>
    • <name> ahora admite un atributo is_anonymous.
    • Se agregó a <reviewer_id>
    • Se quitaron <email>, <pr:role>, <pr:number_of_reviews> y <link>
    • <pr:author_rating> ahora es <ratings> y se incluye fuera del elemento de autor
      • <pr:attr name=”overall”> ahora es <overall> El atributo value ahora es el contenido del elemento.
      • Se quitaron los elementos <pr:attr> adicionales
  • Se quitó <content> atributo de longitud completa
  • Se quitó el atributo de tipo <title>

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

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

Información del contenido:

  • Se quitó el atributo <content> full_length
  • Se quitaron el elemento <video> y sus elementos secundarios
  • Se agregaron los elementos superiores <reviewer_images> y <reviewer_image>.
    • Los elementos <reviewer_image> contienen un elemento <url> para la ubicación de la imagen.

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

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

Información del producto:

  • <pr:products> con <pr:product> elementos secundarios ahora son <products> con <product> secundarios
  • Los elementos <pr:product_id> con atributos contenttype ahora son elementos <product_id> con elementos de tipo de contenido como elementos secundarios (<gtins>, <mpns>, <skus>)
  • <pr:brand> ahora es un elemento secundario en <product_id>
  • <pr:product_name> ahora es <product_name>.
  • Se quitaron <pr:product_category> elementos
  • <link> ahora es <product_url>.
  • Se quitó <pr:number_of_reviews> elemento
  • Se quitaron <pr:average_rating> y todos los elementos secundarios

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

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

Información sobre la calificación:

  • Los elementos <pr:pros> ahora son elementos <pros> con elementos secundarios <pro>
  • Los elementos <pr:cons> ahora son elementos <cons> con elementos secundarios <con>
  • Se quitaron <pr:awards> y todos los elementos secundarios
  • Se quitó <pr:overview> elemento
  • Se quitaron <pr:ratings> elementos de calificaciones de atributos individuales

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

Versión 2.3

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

Información adicional:

  • Se quitaron <pr:custom> elementos y sus elementos secundarios
  • Se quitaron <pr:related_products> elementos y sus elementos secundarios
  • Se agregó <is_spam> elemento
  • Se agregó <collection_method> elemento
  • Se agregó <transaction_id> elemento

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

Versión 2.3

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

Opiniones borradas

Las especificaciones del feed de opiniones ya no admiten un atributo de eliminación. Para borrar opiniones, omítelas de tu feed. Se borrarán las opiniones enviadas anteriormente que no se incluyan en tu próximo feed.

Versión 1

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

Versión 2

Ya no se admite en la versión 2. Si quieres borrar opiniones, no las incluyas en el siguiente feed.