مرجع مخطط XML

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

يمكنك الاطّلاع على مزيد من المعلومات حول مخطّطات XML من خلال مقدمة حول مخطّط XML.

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

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

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

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

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

العنصر موضع الورود النوع الوصف
<version> مطلوب (1) xs:string تشير هذه السمة إلى إصدار مخطط خلاصة مراجعات المنتجات المستخدَم. في الوقت الحالي، لا يمكن استخدام سوى <version>2.4</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 رابط يؤدي إلى رمز الموقع الصغير الخاص بالناشر يجب أن تكون أبعاد الصورة بحجم رمز الموقع المفضّل: 16x16 بكسل. يجب أن يكون تنسيق الصورة GIF أو JPG أو PNG.

<reviews>

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

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

<review>

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

العنصر موضع الورود النوع الوصف
<review_id> مطلوب (1) nonEmptyStringType المعرّف الدائم والفريد لمراجعة المنتج في نظام الناشر
<reviewer> مطلوب (1) reviewerType تمثّل هذه السمة مؤلف مراجعة المنتج.
<is_verified_purchase> اختياري (1) xs:boolean تشير هذه السمة إلى ما إذا تم التأكّد من أنّ المراجع اشترى المنتج.
<is_incentivized_review> اختياري (1) xs:boolean تُستخدَم لتحديد ما إذا كان تمت مكافأة المراجع مقابل مراجعة المنتج أم لا.
<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 تمثّل هذه السمة محتوى المراجعة.
<review_language> اختياري (1) xs:string لغة المراجعة (BCP 47)
<review_country> اختياري (1) xs:string تمثّل هذه السمة رمز البلد (ISO 3166-1) الخاص بالمراجع.
<pros> اختياري (1) xs:sequence تحتوي هذه السمة على الإيجابيات استنادًا إلى رأي المراجع. يجب حذف النص النموذجي، مثل "الإيجابيات:"، ما لم يكن قد كتبه المراجع.
<cons> اختياري (1) xs:sequence تحتوي هذه السمة على السلبيات استنادًا إلى رأي المراجع. احذف النصوص الجاهزة، مثل "العيوب:"، ما لم يكتبها المراجع.
<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

ميزة فردية استنادًا إلى رأي المراجع يجب إدراج الإيجابيات بالترتيب نفسه الذي تظهر به. احذف النص النموذجي، مثل "الإيجابيات:"، ما لم يكن قد كتبه المراجع.

مثال:

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

<cons>

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

العنصر موضع الورود النوع الوصف
<con> مطلوب (من 1 إلى عدد غير محدود) nonEmptyStringType

عيوب فردية استنادًا إلى رأي المراجع يجب إدراج السلبيات بالترتيب نفسه الذي تظهر به. احذف النص النموذجي، مثل "العيوب:"، ما لم يكن قد كتبه المراجع.

مثال:

<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 (أرقام السلع التجارية العالمية) المرتبطة بمنتج. تتوفّر الأنواع الفرعية من أرقام GTIN (مثل الرمز العالمي للمنتج أو رقم EAN أو رقم ISBN أو رقم JAN).
<mpns> مطلوبة (لكل المراجعات المرتبطة بمنتجات تحمل رقم MPN معروفًا)

اختيارية لكل المراجعات الأخرى (1)		 mpnsType تحتوي على أرقام القطع المحدّدة من الشركة المصنّعة (MPN) المرتبطة بمنتج.
<skus> مطلوبة (لكل المراجعات المرتبطة بمنتجات لها رمز تخزين تعريفي معروف)

اختيارية لكل المراجعات الأخرى (1)		 skusType يحتوي على رموز التخزين التعريفية (SKU) المرتبطة بمنتج. يتطابق هذا المعرّف غالبًا مع معرّف العرض في خلاصة المنتجات.
<brands> مطلوبة (لجميع المراجعات المرتبطة بمنتجات تحمل علامة تجارية معروفة)

اختيارية لجميع المراجعات الأخرى (1)		 brandsType تحتوي على أسماء العلامات التجارية المرتبطة بمنتج.
<asins> اختياري (1) asinsType تحتوي على أرقام ASIN (أرقام التعريف المعيارية في Amazon) المرتبطة بمنتج.

<gtins>

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

العنصر موضع الورود النوع الوصف
<gtin> مطلوب (من 1 إلى عدد غير محدود) nonEmptyStringType تمثّل الرقم التجاري العالمي للسلعة الخاص بالمنتج. تتوفّر الأنواع الفرعية من أرقام GTIN (مثل الرمز العالمي للمنتج أو رقم EAN أو رقم ISBN أو رقم JAN).

<mpns>

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

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

<skus>

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

العنصر موضع الورود النوع الوصف
<sku> مطلوب (من 1 إلى عدد غير محدود) nonEmptyStringType رمز التخزين التعريفي للمنتج في مستودع الناشر

<brands>

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

العنصر موضع الورود النوع الوصف
<brand> مطلوب (من 1 إلى عدد غير محدود) nonEmptyStringType تمثّل هذه السمة اسم العلامة التجارية للمنتج.

<asins>

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

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