این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

دستورالعمل های انتقال V1 (منسوخ شده) به V2

قالب V1 منسوخ شده است. موارد زیر تغییرات از فید V1 به فید V2.3 فعلی را نشان می دهد. لطفاً برای مشاهده نمونه کامل آخرین فید 2.3 به https://developers.google.com/product-review-feeds/sample/ مراجعه کنید.

نسخه 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 برای ارجاع به w3.org XMLSchema-versioning اضافه شد. مکان طرح باید به 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> است و خارج از عنصر نویسنده گنجانده شده است
  - <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> حاوی یک عنصر <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> با ویژگی‌های contenttype اکنون عناصر <product_id> با عناصر نوع محتوا در کودکی هستند ( <gtins> ، <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 پشتیبانی نمی شود. نظرات را با درج نکردن آنها در فید بعدی حذف کنید.

دستورالعمل های انتقال V1 (منسوخ شده) به V2

سرتیتر

نسخه 1

نسخه 2.3

نسخه طرحواره

اطلاعات ناشر

نسخه 1

نسخه 2.3

گروه بررسی

نسخه 1

نسخه 2.3

بررسی اطلاعات

اطلاعات خلاصه:

نسخه 1

نسخه 2.3

اطلاعات نویسنده:

نسخه 1

نسخه 2.3

اطلاعات محتوا:

نسخه 1

نسخه 2.3

اطلاعات محصول:

نسخه 1

نسخه 2.3

اطلاعات رتبه بندی:

نسخه 1

نسخه 2.3

اطلاعات تکمیلی:

نسخه 1

نسخه 2.3

بررسی های حذف شده

نسخه 1

نسخه 2