مرجع طرحواره XML

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

عنوان: مرجع طرحواره XML

طرح XML برای فیدهای بررسی محصولات Google ساختار قابل قبول فید XML شما را تعریف می کند. طرحواره های XML از پسوند فایل .xsd استفاده می کنند. مانند فایل‌های DTD، طرح XML عناصر و ویژگی‌هایی را که می‌توانند در یک سند XML ظاهر شوند، تعریف می‌کند.

می توانید از این XML Schema Primer درباره طرحواره های 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 پیوندی به فاویکون شرکت ناشر. ابعاد تصویر باید اندازه فاویکون باشد: 16x16 پیکسل. فرمت تصویر باید 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 حاوی نکات مثبت بر اساس نظر بازبین است. متن boilerplate مانند "pro:" را حذف کنید، مگر اینکه توسط بازبین نوشته شده باشد.
<cons> اختیاری (1) xs:sequence حاوی معایب بر اساس نظر داور است. متن boilerplate مانند "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

یک حرفه ای فردی بر اساس نظر داور. نکات مثبت باید به همان ترتیبی که نمایش داده می شوند فهرست شوند. متن boilerplate مانند "pro:" را حذف کنید، مگر اینکه توسط بازبین نوشته شده باشد.

مثال:

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

<cons>

حاوی معایب بر اساس نظر داور است. عنصر <cons> حاوی این عناصر به ترتیب فهرست شده است.

عنصر وقوع تایپ کنید شرح
<con> مورد نیاز (1-نامحدود) nonEmptyStringType

یک تقلب فردی بر اساس نظر داور. معایب باید به همان ترتیبی که نمایش داده می شوند فهرست شوند. متن boilerplate مانند "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 لازم نیست با پسوند فایل تصویری ختم شود.

مثال:

<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> را داشته باشد.

<product_ids>

شناسه های مرتبط با یک محصول عنصر <product_ids> حاوی این عناصر به ترتیب فهرست شده است.

عنصر وقوع تایپ کنید شرح
<gtins> مورد نیاز (برای همه بررسی های مرتبط با محصولات با GTIN شناخته شده برای فعال کردن تطابق کامل بررسی)

اختیاری (اکیداً توصیه می شود) برای همه نظرات دیگر (1)		 gtinsType حاوی GTIN (شماره کالاهای تجاری جهانی) مرتبط با یک محصول.
<mpns> الزامی است (اگر محصول مرتبط با بازبینی دارای GTIN اختصاصی نیست، باید برای تسهیل تطبیق مرور لحاظ شود. باید همراه با نام تجاری ارسال شود)

اختیاری برای همه نظرات دیگر (1)		 mpnsType حاوی MPN (شماره قطعه سازنده) مرتبط با یک محصول.
<skus> الزامی است (اگر محصول مرتبط با بررسی دارای GTIN یا MPN اختصاصی نیست، باید برای تسهیل تطبیق مرور لحاظ شود. باید با نام تجاری ارسال شود)

اختیاری برای همه نظرات دیگر (1)		 skusType حاوی SKU (واحد نگهداری سهام) مرتبط با یک محصول. اغلب این با شناسه پیشنهاد محصول در فید محصول مطابقت دارد.
<brands> الزامی است (اگر محصول مرتبط با بررسی GTIN اختصاصی ندارد، باید برای تسهیل تطبیق بازبینی درج شود. باید با MPN ارسال شود)

اختیاری برای همه نظرات دیگر (1)		 brandsType شامل نام های تجاری مرتبط با یک محصول است.
<asins> اختیاری (1) asinsType حاوی ASIN (شماره‌های شناسایی استاندارد آمازون) مرتبط با یک محصول.

<gtins>

حاوی GTIN (شماره کالاهای تجاری جهانی) مرتبط با یک محصول. عنصر <gtins> حاوی این عناصر به ترتیب فهرست شده است.

عنصر وقوع تایپ کنید شرح
<gtin> مورد نیاز (1-نامحدود) nonEmptyStringType شماره کالای تجارت جهانی محصول.

<mpns>

حاوی MPN (شماره قطعه سازنده) مرتبط با یک محصول. عنصر <mpns> حاوی این عناصر به ترتیب فهرست شده است.

عنصر وقوع تایپ کنید شرح
<mpn> مورد نیاز (1-نامحدود) nonEmptyStringType شماره قطعه سازنده محصول

<skus>

حاوی SKU (واحد نگهداری سهام) مرتبط با یک محصول. عنصر <skus> حاوی این عناصر به ترتیب فهرست شده است.

عنصر وقوع تایپ کنید شرح
<sku> مورد نیاز (1-نامحدود) nonEmptyStringType واحد نگهداری کالا در فهرست موجودی ناشر.

<brands>

شامل نام های تجاری مرتبط با یک محصول است. عنصر <brands> حاوی این عناصر به ترتیب فهرست شده است.

عنصر وقوع تایپ کنید شرح
<brand> مورد نیاز (1-نامحدود) nonEmptyStringType نام تجاری محصول.

<asins>

حاوی ASIN (شماره‌های شناسایی استاندارد آمازون) مرتبط با یک محصول. را عنصر حاوی این عناصر به ترتیب فهرست شده است.

عنصر وقوع تایپ کنید شرح
<asin> مورد نیاز (1-نامحدود) nonEmptyStringType شماره شناسایی استاندارد آمازون محصول. هر ASIN دارای 10 کاراکتر طول و الفبایی است.