Инструкции по переходу с V1 (устарело) на V2

Формат V1 устарел. Ниже описаны изменения из фида V1 в текущий фид V2.3. См. https://developers.google.com/product-review-feeds/sample/ полный пример последней версии фида 2.3.

Версия 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”>

Версия 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">

Элементы xmlns:atom и xmlns:pr удалены. Был добавлен элемент xmlns:vc для ссылки на управление версиями XMLSchema w3.org. Расположение схемы должно быть обновлено до версии 2.3 xsd .

Версия схемы

Версия схемы теперь указывается после заголовка

<version>2.3</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>

Версия 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>

Группа обзора

Ранее обзоры обозначались повторяющимися элементами <entry> . В ленте 2.3 элементы <review> заменили элементы <entry> и сгруппированы под родительским элементом <reviews> .

Версия 1

<entry>
...
</entry>

Версия 2.3

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

Обзор информации

Раздел содержания обзора был значительно упрощен. Для достижения этого упрощения были изменены следующие поля:

Сводная информация:

  • <id> теперь <review_id>
  • <published> теперь <review_timestamp>
  • <pr:content_format> был удален
  • <link> теперь <review_url>

Версия 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"/>

Версия 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>

Информация об авторе:

  • <author> теперь <reviewer>
    • <name> теперь поддерживает атрибут is_anonymous
    • <reviewer_id> добавлен
    • <email> , <pr:role> , <pr:number_of_reviews> и <link> были удалены.
    • <pr:author_rating> теперь называется <ratings> и включен вне элемента author.
      • <pr:attr name=”overall”> теперь <overall> . Атрибут value теперь является содержимым элемента.
      • Дополнительные элементы <pr:attr> удалены.
  • Атрибут <content> full_length удален.
  • Атрибут типа <title> был удален

Версия 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>

Версия 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>

Информация о содержании:

  • Атрибут <content> full_length удален.
  • Элемент <video> и его дочерние элементы были удалены.
  • Добавлены родительский элемент <reviewer_images> <reviewer_image> и дочерние элементы <reviewer_image>.
    • Элементы <reviewer_image> содержат элемент <url> для местоположения изображения.

Версия 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>

Версия 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>

Информация о продукте:

  • <pr:products> с дочерними элементами <pr:product> теперь являются <products> с дочерними элементами <product>
  • Элементы <pr:product_id> с атрибутами типа контента теперь являются элементами <product_id> с элементами типа контента в качестве дочерних ( <gtins> contenttype <mpns> , <skus> )
  • <pr:brand> теперь является дочерним элементом <product_id>
  • <pr:product_name> теперь <product_name>
  • Элементы <pr:product_category> были удалены
  • <link> теперь <product_url>
  • Элемент <pr:number_of_reviews> удален.
  • <pr:average_rating> и все дочерние элементы были удалены

Версия 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>

Версия 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>

Информация о рейтинге:

  • Элементы <pr:pros> теперь являются элементами <pros> с дочерними элементами <pro>
  • Элементы <pr:cons> теперь являются элементами <cons> с дочерними элементами <con>
  • <pr:awards> и все дочерние элементы были удалены
  • Элемент <pr:overview> был удален
  • Элементы <pr:ratings> для рейтинга отдельных атрибутов были удалены.

Версия 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>

Версия 2.3

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

Дополнительная информация:

  • Элементы <pr:custom> и их дочерние элементы удалены.
  • <pr:related_products> и их дочерние элементы были удалены.
  • Добавлен элемент <is_spam>
  • Добавлен элемент <collection_method>
  • Добавлен элемент <transaction_id>

Версия 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>

Версия 2.3

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

Удаленные отзывы

Спецификация ленты отзывов больше не поддерживает атрибут удаления. Чтобы удалить отзывы, не добавляйте их в свою ленту. Любые ранее отправленные обзоры, не включенные в вашу следующую ленту, будут удалены.

Версия 1

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

Версия 2

Больше не поддерживается в версии 2. Удалите отзывы, не включая их в следующую ленту.