طرحواره XML

این بخش طرح XML مورد استفاده برای فید داده های بازبینی بازرگان را شرح می دهد.

عنصر سطح بالا: <feed>

شرح

بالاترین عنصر ظرفی که همه عناصر دیگر را در خوراک نگه می‌دارد.

ویژگی های

نام قالب ظهور شرح
xmlns xs: رشته مورد نیاز (1) لطفا مقدار زیر را کد سخت کنید:
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs: رشته مورد نیاز (1) لطفا مقدار زیر را کد سخت کنید:
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs: رشته مورد نیاز (1) لطفاً مقدار زیر را کد سخت کنید و یک فضای خالی بین URL ها باقی بگذارید:
http://schemas.google.com/merchant_reviews/5.0 http://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd

مثال

<feed xmlns="http://schemas.google.com/merchant_reviews/5.0"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="http://schemas.google.com/merchant_reviews/5.0 https://www.gstatic.com/productsearch/static/reviews/5.0/merchant_reviews.xsd">

حاوی

نام قالب ظهور شرح
merchants -- اختیاری (0-1) عنصر ظرف برای عناصر <merchant> .
deleted_merchants -- اختیاری (0-1) عنصر کانتینر برای عناصر <deleted_merchant> .
reviews -- اختیاری (0-1) عنصر ظرف برای عناصر <review> .
deleted_reviews -- اختیاری (0-1) عنصر ظرف برای عناصر <deleted_review> .

<merchants>

شرح

ظرفی برای عناصر <merchant> .

حاوی

نام قالب ظهور شرح
merchant -- مورد نیاز (1‑n) عنصر تکرار شده برای هر تاجر.

<merchant>

شرح

هر عنصر <merchant> حاوی اطلاعات و نظرات برای یک تاجر است.

ویژگی های

نام قالب ظهور شرح
id شناسه مورد نیاز (1) باید در همه فیدها منحصر به فرد و پایدار باشد. به عبارت دیگر، اگر فید امروز و فید 90 روز پیش به یک تاجر اشاره داشته باشد، باید شناسه یکسانی داشته باشند.

مثال

<merchant id="2739">

حاوی

لطفاً عناصر زیر را در عنصر تاجر قرار دهید.

نام قالب ظهور شرح
name NonEmptyString مورد نیاز (1) نام نمایشی قابل خواندن توسط انسان برای تاجر.
merchant_url xs:anyURI مورد نیاز (1) نشانی وب سایت اصلی تاجر.
از URL تغییر مسیر برای این مقدار استفاده نکنید. به عبارت دیگر، مقدار باید مستقیماً به سایت تاجر اشاره کند.

مثال: 

<merchant_url>
  http://store.google.com
</merchant_url>

rating_url xs:anyURI مورد نیاز (1) نشانی وب صفحه فرود که میزبان نظرات این تاجر است.
از URL تغییر مسیر استفاده نکنید.

مثال: 

<rating_url>
  http://merchant_url.com/reviews/
</rating_url>

create_timestamp DateTimeWithTimeZone مورد نیاز (1) زمان/تاریخ ایجاد تاجر. این هرگز نباید تغییر کند.
last_update_timestamp DateTimeWithTimeZone مورد نیاز (1) زمان/تاریخ آخرین به‌روزرسانی تاجر. اگر هر یک از فیلدهای عنصر <merchant> برای شناسه تجاری معین به روز شود، این مقدار نیز باید تغییر کند.

<deleted_merchants>

شرح

کانتینری برای بازرگانان که حذف شدند.

حاوی

نام قالب ظهور شرح
deleted_merchant -- مورد نیاز (1‑n) حاوی عنصر(های) مربوط به یک تاجر حذف شده است.

<deleted_merchant>

شرح

تاجری که حذف شد.

ویژگی های

نام قالب ظهور شرح
id شناسه مورد نیاز (1) شناسه تاجری را مشخص می‌کند که باید از فید حذف شود. شناسه باید با ویژگی id عنصر <merchant> در هر فایل فید قبلی مطابقت داشته باشد.

حاوی

نام قالب ظهور شرح
last_update_timestamp DateTimeWithTimeZone مورد نیاز (1) زمان/تاریخ حذف یک تاجر از سیستم.

مثال: 

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>

مثال

<deleted_merchant id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z</last_update_timestamp>
</deleted_merchant>

<reviews>

شرح

ظرف برای عناصر <review> .

حاوی

نام قالب ظهور شرح
review -- مورد نیاز (1‑n) عنصر برای هر مرور تکرار می شود.

<review>

شرح

ظرف برای جزئیات مربوط به بررسی.

ویژگی های

نام قالب ظهور شرح
id شناسه مورد نیاز (1) شناسه برای بررسی در سیستم شما. باید در همه فیدها منحصر به فرد و پایدار باشد.

مثال: 

<review id=132739 mid=1234>

mid شناسه مورد نیاز (1) شناسه تاجری که این بررسی برای آن است.

حاوی

لطفاً عناصر زیر را در عنصر بررسی قرار دهید.

نام قالب ظهور شرح
reviewer_name NonEmptyString اختیاری (0-1) نام نمایشی نویسنده نظر، مشروط بر اینکه نظر باید نویسنده نام داشته باشد. نظرات ناشناس نباید شامل این قسمت باشد.

مثال: 

<reviewer_name>
  Joel
</reviewer_name>

create_timestamp DateTimeWithTimeZone مورد نیاز (1) زمان/تاریخ ارسال بررسی توسط کاربر. این هرگز نباید تغییر کند.

مثال: 

<create_timestamp>
  2016-04-03T18:37:32Z
</create_timestamp>

last_update_timestamp DateTimeWithTimeZone مورد نیاز (1) زمان/تاریخ آخرین تغییر اطلاعات عنصر <review> . اگر هر یک از فیلدهای عنصر <review> برای شناسه بررسی معین به روز شود، این مقدار نیز باید تغییر کند.

مثال: 

<last_update_timestamp>
  2016-04-03T18:37:32Z
</last_update_timestamp>

country_code کد کشور مورد نیاز (1) کشور داور. در صورت موجود بودن، این کشوری است که محصول به آن ارسال شده است یا جایی که خدمات ارائه شده است. در غیر این صورت، از کشوری استفاده کنید که بازبین در نقطه ایجاد نظر در آن است. کد کشور باید در قالب ISO 3166-1 آلفا-2 باشد.

مثال: 

  <country_code>
    US
  </country_code>

title xs: رشته اختیاری (0-1) عنوان بررسی. عنوان باید متن ساده و بدون هیچ گونه برچسب HTML در آن باشد.

مثال: 

  <title>
    Great prices
  </title>

content xs: رشته مورد نیاز (1) محتوای بررسی. این باید هر متن آزاد ارائه شده توسط کاربر باشد و نباید کوتاه شود. محتوا باید متن ساده و بدون هیچ گونه برچسب HTML در آن باشد. به عنوان مثال، شکست خط باید با یک کاراکتر فید خط نشان داده شود، نه یک تگ <br>. اگر پاسخ‌های متعددی به سؤالات مختلف ارائه شود، همه پاسخ‌ها باید گنجانده شوند، با حداقل زمینه برای منطقی بودن پاسخ‌ها. اگر سؤالات بدون پاسخ رها شدند، نباید زمینه ارائه شود.

مثال: 

  <content>
    I like this store!
    My order arrived on time and I got
    a great price.
  </content>

مثال: 

  <content>
    Positives: Great prices.
    Suggestions: Selection could be better.
  </content>
ratings -- مورد نیاز (1) عنصر ظرف برای رتبه‌بندی بازبین از تاجر. اگر هیچ رتبه‌بندی برای عنصر <overall> در دسترس نباشد، کل بررسی مرتبط باید از فید حذف شود زیرا عنصر <overall> لازم است و بررسی بدون آن پذیرفته نخواهد شد.
collection_method CollectionMethodType مورد نیاز (1) روشی که برای جمع آوری مرور استفاده شد. مقدار باید یکی از موارد زیر باشد:
  • ناخواسته: کاربر در هنگام ارسال بررسی به درخواست خاصی پاسخ نمی‌دهد.
  • point_of_sale: کاربر در پاسخ به درخواستی که کاربر سفارشی را ثبت کرد، نظر را ارسال کرد.
  • after_fulfillment: کاربر در پاسخ به درخواست پس از انجام سفارش کاربر، بررسی را ارسال کرد.

مثال: 

  <collection_method>
    after_fulfillment
  </collection_method>

<ratings>

شرح

شامل رتبه‌بندی بازبین از تاجر است. اگر هیچ رتبه‌بندی برای عنصر <overall> در دسترس نباشد، کل بررسی مرتبط باید از فید حذف شود زیرا عنصر <overall> لازم است و بررسی بدون آن پذیرفته نخواهد شد.

حاوی

لطفاً عناصر زیر را در عنصر رتبه‌بندی قرار دهید.

نام قالب ظهور شرح
overall محدوده رتبه بندی مورد نیاز (1) رتبه بندی کلی بازبین برای یک تاجر.

مثال: 

  <overall min="1" max="10">9</overall>

customer_service محدوده رتبه بندی اختیاری (0-1) رتبه بندی بازبین از کیفیت خدمات مشتری برای این تاجر.

مثال: 

  <customer_service min="1" max="5">3</customer_service>

<deleted_reviews>

شرح

کانتینری برای بررسی که حذف شد.

حاوی

نام قالب ظهور شرح
deleted_review -- مورد نیاز (1‑n) حاوی عنصر(های) مربوط به یک بررسی حذف شده است.

<deleted_review>

شرح

مروری که حذف شد.

ویژگی های

نام قالب ظهور شرح
id شناسه مورد نیاز (1) شناسه مروری را مشخص می‌کند که باید از فید حذف شود. شناسه باید با ویژگی id عنصر <review> در هر فایل فید مطابقت داشته باشد.

حاوی

نام قالب ظهور شرح
last_update_timestamp DateTimeWithTimeZone مورد نیاز (1) زمانی که یک مرور از سیستم حذف شد.

مثال: 

  <last_update_timestamp>
    2016-04-03T18:37:32Z
  </last_update_timestamp>

مثال

<deleted_review id="10">
  <last_update_timestamp>2014-07-12T07:55:06Z<last_update_timestamp>
</deleted_review>