مرجع مخطط XML

الكتاب: /product-review-feeds/_book.yaml

Title: مرجع مخطط XML

يحدّد مخطط XML لخلاصات مراجعة منتجات Google البنية المقبولة لخلاصة XML. تستخدم مخطّطات XML امتداد الملف .xsd. مثل ملفات DTD، يحدّد مخطط XML العناصر والسمات التي يمكن أن تظهر في مستند XML.

يمكنك التعرّف على مزيد من المعلومات حول مخططات XML من هذا الإعداد الأولي لمخطّط XML.

ويتوفّر مخطّط XML لخلاصات مراجعة المنتجات هنا: http://www.google.com/shopping/reviews/schema/product/2.3/product_reviews.xsd.

يتبع وصف بنية الخلاصة المحددة بواسطة هذا المخطط. في هذا الوصف، تشير أسماء الأنواع ذات البادئة xs: إلى أنواع مخططات XML المدمَجة التي تكون في مساحة اسم XML http://www.w3.org/2001/XMLSchema.

يتوقّع نظامنا دائمًا خلاصة كاملة. سيتم حذف أي مراجعات تم إرسالها سابقًا، ولكن لم يتم تضمينها في خلاصتك الكاملة التالية. لذلك، عليك دائمًا إرسال جميع المراجعات عند إرسال خلاصتك.

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

يحتوي العنصر <feed> على هذه العناصر بالترتيب المذكور.

عنصر التكرار النوع الوصف
<version> مطلوب (1) xs:string يشير هذا العمود إلى الإصدار الذي يستخدِم مخطط خلاصة مراجعات المنتج. في الوقت الحالي، يمكن استخدام <version>2.3</version> فقط.
<aggregator> اختياري (1) aggregatorType يمكن للناشر استخدام مجمِّع المراجعات لإدارة المراجعات وتقديم الخلاصات. يشير هذا العنصر إلى استخدام مجمِّع الموسيقى ويحتوي على معلومات عن مجمِّع الموسيقى.
<publisher> مطلوب (1) publisherType المعلومات المتعلقة بالناشر، والتي قد تكون بائع تجزئة أو الشركة المُصنّعة أو شركة مراجعات الخدمة أو أي كيان ينشر مراجعات المنتج.
<reviews> اختياري (1) xs:sequence يتضمن مراجعات المنتج.

تحدّد السمة <feed> قيود التفرّد على العناصر المستخدمة في الخلاصة.

العناصر الثانوية

<aggregator>

ويجوز للناشر استخدام خدمة تجميع المراجعات لإدارة المراجعات وتقديم الخلاصات. يشير هذا العنصر إلى استخدام أداة التجميع ويحتوي على معلومات حول العارض. يحتوي العنصر <aggregator> على هذه العناصر بالترتيب المذكور.

عنصر التكرار النوع الوصف
<name> مطلوب (1) nonEmptyStringType اسم مجمِّع مراجعات المنتج.

<publisher>

المعلومات المتعلقة بالناشر، والتي قد تكون بائع تجزئة أو شركة مصنّعة أو شركة خدمات المراجعات أو أي كيان ينشر مراجعات منتجات، ويحتوي العنصر <publisher> على هذه العناصر بالترتيب المدرَج.

عنصر التكرار النوع الوصف
<name> مطلوب (1) nonEmptyStringType اسم ناشر مراجعات المنتج.
<favicon> اختياري (1) httpUrlType رابط إلى الرمز المفضل للشركة للناشر. يجب أن تكون أبعاد الصورة بحجم رمز مفضّل: 16×16 بكسل. يجب أن يكون تنسيق الصورة هو GIF أو JPG أو PNG.

<reviews>

تحتوي هذه السمة على مراجعات المنتج. يحتوي العنصر <reviews> على هذه العناصر بالترتيب المذكور.

عنصر التكرار النوع الوصف
<review> مطلوب (1-غير محدود) reviewType تمثّل هذه السمة مراجعة المنتج الفريدة. إذا كانت المراجعة تتعلق بمنتجات متعددة في مستودع الناشر، يجب تحديد المراجعة مرة واحدة وتضمين عناصر <product> متعددة في العنصر <products>.

<review>

تمثّل هذه السمة مراجعة المنتج الفريدة. إذا كانت المراجعة تتعلق بمنتجات متعددة في مستودع الناشر، يجب تحديد المراجعة مرة واحدة وتضمين عناصر <product> متعددة في العنصر <products>.ويحتوي العنصر <review> على هذه العناصر بالترتيب المذكور.

عنصر التكرار النوع الوصف
<review_id> اختياري (1) nonEmptyStringType المعرّف الدائم والفريد لمراجعة المنتج في نظام الناشر.
<reviewer> مطلوب (1) reviewerType تمثّل هذه السمة مؤلف مراجعة المنتج.
<review_timestamp> مطلوب (1) xs:dateTime

الطابع الزمني الذي يشير إلى وقت كتابة المراجعة

أمثلة:

2014-04-21T11:07:07-06:00
2014-04-21T18:00:00+01:00
2014-04-21T00:00:00Z
<title> اختياري (1) nonEmptyStringType تمثّل هذه السمة عنوان المراجعة.
<content> مطلوب (1) nonEmptyStringType محتوى المراجعة.
<pros> اختياري (1) xs:sequence يحتوي على الإيجابيات بناءً على رأي المُراجع. احذف النص النموذجي مثل "pro;pro:" ما لم يكتبه المراجع.
<cons> اختياري (1) xs:sequence يحتوي على السلبيات بناءً على رأي المُراجع. يجب حذف النص النموذجي مثل "con:"ما لم يُكتبه المُراجع.
<reviewer_images> اختياري (1) xs:sequence تحتوي هذه العلامة على روابط إلى صور المنتج التي قدّمها المراجع.
<review_url> مطلوب (1) reviewUrlType تمثّل هذه السمة عنوان URL للصفحة المقصودة للمراجعة.
<ratings> مطلوب (1) xs:sequence يحتوي على التقييمات المرتبطة بالمراجعة.
<products> مطلوب (1) xs:sequence تحتوي على المنتجات المرتبطة بالمراجعة.
<is_spam> اختياري (1) xs:boolean تشير هذه السمة إلى ما إذا تم وضع علامة على المراجعة باعتبارها محتوى غير مرغوب فيه في نظام الناشر.
<collection_method> اختياري (1) collectionMethodType

الطريقة المستخدَمة لجمع المراجعة. ويجب أن تكون القيمة من بين القيم التالية:

unsolicited
لم يستجب المستخدم لطلب معيّن عند إرسال المراجعة.
post_fulfillment
أرسل المستخدم المراجعة ردًا على طلب تحقّق بعد استيفاء طلب المستخدم.
<transaction_id> اختياري (1) nonEmptyStringType تمثّل هذه الخاصية معرّفًا دائمًا وفريدًا للمعاملة المرتبطة بالمراجعة في نظام الناشر. ويمكن استخدام رقم التعريف هذا للإشارة إلى أنّ عدة مراجعات ترتبط بالمعاملة نفسها.

<reviewer>

تمثّل هذه السمة مؤلف مراجعة المنتج. يحتوي العنصر <reviewer> على هذه العناصر بالترتيب المذكور.

عنصر التكرار النوع الوصف
<name> مطلوب (1) reviewerNameType

تمثّل هذه السمة اسم مؤلف المراجعة.

مثال:

<name>Jane</name>
<reviewer_id> اختياري (1) nonEmptyStringType

تمثّل هذه السمة معرّفًا دائمًا وفريدًا لمؤلف المراجعة في نظام الناشر.

مثال:

<reviewer_id>14295</reviewer_id>

<name>

تمثّل هذه السمة اسم مؤلف المراجعة. يمثّل العنصر <name> إضافةً إلى nonEmptyStringType ويحتوي على اسم المُراجع أو اسمه المستعار. يحتوي العنصر <name> على هذه السمات.

السمة التكرار النوع الوصف
is_anonymous اختيارية xs:boolean

تشير هذه السمة إلى ما إذا كان المُراجع مجهول الهوية.

مثال:

<name is_anonymous="true">Anonymous</name>

<pros>

يحتوي على الإيجابيات بناءً على رأي المُراجع. يحتوي العنصر <pros> على هذه العناصر بالترتيب المذكور.

عنصر التكرار النوع الوصف
<pro> مطلوب (1-غير محدود) nonEmptyStringType

محترف فردي استنادًا إلى رأي المُراجع. يجب أن يتم سرد الإيجابيات بنفس الترتيب الذي يتم عرضها به. احذف النص النموذجي مثل "pro;pro:" ما لم يكتبه المُراجع.

مثال:

<pros>
  <pro>Sleek design</pro>
</pros>

<cons>

يحتوي على السلبيات بناءً على رأي المُراجع. يحتوي العنصر <cons> على هذه العناصر بالترتيب المذكور.

عنصر التكرار النوع الوصف
<con> مطلوب (1-غير محدود) nonEmptyStringType

أساس فردي استنادًا إلى رأي المُراجع يجب أن يتم إدراج السلبيات بالترتيب نفسه الذي يتم عرضها به. احذف النص النموذجي مثل "con:"ما لم يكتبه المُراجع.

مثال:

<cons>
  <con>Pricey</con>
</cons>

<review_url>

تمثّل هذه السمة عنوان URL للصفحة المقصودة للمراجعة. العنصر <review_url> هو إضافة من أجل httpUrlType ويحتوي على رابط يؤدي إلى الصفحة المقصودة للمراجعة. يحتوي العنصر <review_url> على هذه السمات.

السمة التكرار النوع الوصف
type مطلوب xs:string

يجب أن يكون النوع واحدًا مما يلي:

singleton
تحتوي صفحة المراجعة على هذه المراجعة الفردية فقط.
group
تحتوي صفحة المراجعات على مجموعة من المراجعات بما في ذلك هذه المراجعة.

مثال:

<review_url type="singleton">http://www.example.com/review_5.html</review_url>

<reviewer_images>

تحتوي على صور للمنتج الذي قدّمه المراجع. تحتوي العلامة <reviewer_images> على العديد من عناصر <reviewer_image>.

عنصر التكرار النوع الوصف
<reviewer_image> مطلوب (1-غير محدود) reviewImageType

صورة للمنتج الذي راجعه ومؤلف المراجعة.

<reviewer_image>

عنصر صورة مراجعة واحد

عنصر التكرار النوع الوصف
<url> مطلوب (1) httpUrlType

تمثّل هذه السمة عنوان URL لصورة المنتج الذي راجعه مؤلف المراجعة. ولا يجب أن ينتهي عنوان 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>

<ratings>

يحتوي على التقييمات المرتبطة بالمراجعة. يحتوي العنصر <ratings> على هذه العناصر بالترتيب المذكور.

عنصر التكرار النوع الوصف
<overall> مطلوب (1) ratingType تمثّل هذه السمة التقييم الإجمالي للمنتج الذي قدّمه المُراجع.

<overall>

تمثّل هذه السمة التقييم الإجمالي للمنتج الذي قدّمه المُراجع. يمتد العنصر <overall> السمة xs:decimal simpleType ويلتقط التقييم الذي حدده المُراجع. يجب أن تكون القيمة ضِمن النطاق الشامل الذي تحدّده السمتَان min وmax. يحتوي العنصر <overall> على هذه السمات.

السمة التكرار النوع الوصف
min مطلوب xs:integer تمثّل هذه السمة أدنى عدد ممكن من التقييمات. ويجب أن يكون أسوأ تقييم ممكن ويجب ألا يكون قيمة بدون تقييم.
max مطلوب xs:integer تمثّل هذه السمة أقصى عدد ممكن للتقييم. ويجب أن تكون قيمة السمة max أكبر من قيمة السمة min.

<products>

تحتوي على المنتجات المرتبطة بالمراجعة. يحتوي العنصر <products> على هذه العناصر بالترتيب المذكور.

عنصر التكرار النوع الوصف
<product> مطلوب (1-غير محدود) productType منتج مرتبط بالمراجعة.

<product>

منتج مرتبط بالمراجعة. يحتوي العنصر <product> على هذه العناصر بالترتيب المذكور.

عنصر التكرار النوع الوصف
<product_ids> اختياري (1) productIdsType المعرّفات المرتبطة بمنتج.
<product_name> اختياري (1) nonEmptyStringType الاسم الوصفي للمنتج.
<product_url> مطلوب (1) httpUrlType عنوان URL للمنتج يمكن أن يحتوي عنوان URL هذا على القيمة نفسها لعنصر <review_url>، إذا كان عنوان URL للمراجعة وعنوان URL للمنتج متطابقَين.

<product_ids>

المعرّفات المرتبطة بمنتج. يحتوي العنصر <product_ids> على هذه العناصر بالترتيب المذكور.

عنصر التكرار النوع الوصف
<gtins> مطلوبة (لجميع المراجعات المرتبطة بالمنتجات التي تحمل رقم GTIN معروفًا لتفعيل مطابقة المراجعات الكاملة)

اختيارية (ننصح بشدة باستخدامها) لكل المراجعات الأخرى (1)		 gtinsType تحتوي على أرقام GTIN (أرقام السلع التجارية العالمية) المرتبطة بمنتج.
<mpns> مطلوبة (يجب تضمين رقم القطعة حسب الشركة المصنّعة لتسهيل مطابقة المراجعات إذا لم يتم تخصيص رقم GTIN للمنتج المرتبط بالمراجعة). يجب إرسالها مع العلامة التجارية.

اختيارية لجميع المراجعات الأخرى (1)		 mpnsType تحتوي هذه العلامة على أرقام MPN (أرقام القطع بحسب الشركة المصنّعة) المرتبطة بمنتج.
<skus> مطلوبة (يجب تضمين رمز التخزين التعريفي (SKU) لتسهيل مطابقة المراجعة، إذا لم يكن المنتج المرتبط بالمراجعة يحمل رقم GTIN أو رقم MPN مخصّصًا. يجب إرسالها مع العلامة التجارية.

اختيارية لجميع المراجعات الأخرى (1)		 skusType تحتوي على رموز التخزين التعريفي (وحدات حفظ المخزون) المرتبطة بالمنتج. وغالبًا ما يتطابق ذلك مع معرّف عرض المنتج في خلاصة المنتج.
<brands> مطلوبة (يجب تضمين العلامة التجارية لتسهيل مطابقة المراجعة إذا لم يتم تخصيص رقم GTIN للمنتج المرتبط بالمراجعة). يجب إرسال رقم القطعة بحسب الشركة المصنّعة
.
اختياري لجميع المراجعات الأخرى (1)		 brandsType تحتوي هذه العلامة على أسماء العلامات التجارية المرتبطة بالمنتج.
<asins> اختياري (1) asinsType تحتوي على أرقام ASIN (أرقام التعريف العادية من Amazon) المرتبطة بالمنتج.

<gtins>

تحتوي على أرقام GTIN (أرقام السلع التجارية العالمية) المرتبطة بمنتج. يحتوي العنصر <gtins> على هذه العناصر بالترتيب المذكور.

عنصر التكرار النوع الوصف
<gtin> مطلوب (1-غير محدود) nonEmptyStringType تمثّل هذه السمة الرقم التجاري العالمي للسلعة.

<mpns>

تحتوي هذه العلامة على أرقام MPN (أرقام القطع بحسب الشركة المصنّعة) المرتبطة بمنتج. يحتوي العنصر <mpns> على هذه العناصر بالترتيب المذكور.

عنصر التكرار النوع الوصف
<mpn> مطلوب (1-غير محدود) nonEmptyStringType رقم القطعة بحسب الشركة المصنّعة للمنتج

<skus>

تحتوي على رموز التخزين التعريفي (وحدات حفظ المخزون) المرتبطة بالمنتج. يحتوي العنصر <skus> على هذه العناصر بالترتيب المذكور.

عنصر التكرار النوع الوصف
<sku> مطلوب (1-غير محدود) nonEmptyStringType وحدة الاحتفاظ بمستودع المنتج في مستودع الناشر.

<brands>

تحتوي هذه العلامة على أسماء العلامات التجارية المرتبطة بالمنتج. يحتوي العنصر <brands> على هذه العناصر بالترتيب المذكور.

عنصر التكرار النوع الوصف
<brand> مطلوب (1-غير محدود) nonEmptyStringType اسم العلامة التجارية للمنتج.

<asins>

تحتوي على أرقام ASIN (أرقام التعريف العادية من Amazon) المرتبطة بمنتج. يحتوي العنصر على هذه العناصر بالترتيب المذكور.

عنصر التكرار النوع الوصف
<asin> مطلوب (1-غير محدود) nonEmptyStringType رقم تعريف Amazon العادي. يبلغ طول كل رقم ASIN 10 أحرف وأرقام أبجدية رقمية.