مخطط XML

يُعيّن هذا القسم التوزيع لمخطط XML المستخدَم لخلاصة بيانات مراجعة التاجر.

عنصر المستوى الأعلى: <feed>

الوصف

عنصر الحاوية العلوي الذي يحتوي على جميع العناصر الأخرى في الخلاصة.

السمات

الاسم التنسيق عدد مرات الظهور الوصف
xmlns xs:string مطلوب (1) يُرجى ترميز القيمة التالية:
http://schemas.google.com/merchant_reviews/5.0
xmlns:xsi xs:string مطلوب (1) يُرجى ترميز القيمة التالية:
http://www.w3.org/2001/XMLSchema-instance
xsi:schemaLocation xs:string مطلوب (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 المؤدي إلى الموقع الإلكتروني الرئيسي للتاجر.
لا تستخدم عنوان URL لإعادة التوجيه لهذه القيمة. وبعبارة أخرى، يجب أن تشير القيمة مباشرةً إلى الموقع الإلكتروني للتاجر.

مثال: 

<merchant_url>
  http://store.google.com
</merchant_url>
rating_url xs:anyURI مطلوب (1) عنوان URL للصفحة المقصودة التي تستضيف المراجعات لهذا التاجر
لا تستخدم عنوان 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 CountryCode (رمز البلد) مطلوب (1) بلد المُراجع يشير هذا المقياس إلى البلد الذي تم فيه شحن المنتج إليه أو الذي تمّ عرض الخدمة فيه، إذا كان ذلك متاحًا. وبخلاف ذلك، استخدِم البلد الذي يتواجد فيه المراجع عند إنشاء المراجعة. ويجب أن يكون رمز البلد بتنسيق ISO 3166-1 alpha-2.

مثال: 

  <country_code>
    US
  </country_code>
title xs:string اختياري (0‐1) تمثّل هذه السمة عنوان المراجعة. يجب أن يكون العنوان نصًا عاديًا بدون أي علامات HTML.

مثال: 

  <title>
    Great prices
  </title>
content xs:string مطلوب (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) تحدّد هذه السمة رقم تعريف المراجعة التي يجب حذفها من الخلاصة. ويجب أن يتطابق المعرّف مع سمة رقم التعريف للعنصر <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>