مخطط 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 RatingRange مطلوب (1) التقييم العام الذي يقدّمه المراجع للتاجر.

مثال: 

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

customer_service RatingRange اختياري (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>