ذکر منابع

این صفحه شرح، مقادیر، و الزامات مشخصه‌ها و عناصر فرزند را پوشش می‌دهد. این مقادیر فقط برای دارایی‌های «اقامتگاه‌های اجاره‌ای» قابل اعمال است.

ساختار کلی XML قالبی مشابه فیدهای فهرستگان هتل دارد. مرجع XML فهرست هتل را ببینید.

درصورت عدم درج موارد الزامی زیر، فهرستگان به‌طور خودکار غیرفعال می‌شود:

  • عناصر فرزند XML الزامی: id، name، latitude، longitude، address.
  • شاخصه‌های الزامی: capacity و website. به پیوندهای مستقیم اقامتگاه‌های اجاره‌ای در فید فهرستگان خود مراجعه کنید. این کار به کاربران فرصت می‌دهد از وب‌سایت ملک بازدید کنند.

برای جزئیات عناصر فرزند XML موردنیاز، به عناصر فرزند XML مراجعه کنید.

برای اطلاعات بیشتر درباره «اقامتگاه‌های اجاره‌ای»، به مشخصه‌های مختص «اقامتگاه‌های اجاره‌ای» مراجعه کنید.

درنهایت، وقتی Google ازطریق منابع دیگر تشخیص دهد که مقدار یک مشخصه با آنچه در فید برای فهرست اقامتگاه اجاره‌ای مشخص شده است تفاوت دارد، Google مقدار را برای فهرست نمایش می‌دهد. برای مثال، اگر Google از عکس‌های فهرستگان تشخیص دهد که آشپزخانه دارد، اما مشخصه kitchen وجود نداشته باشد یا روی No تنظیم شده باشد، Google فهرستگان را به‌عنوان مکانی که آشپزخانه دارد درنظر می‌گیرد. به این مشخصه‌ها «مشخصه‌های استنباط‌شده» می‌گویند و فقط زمانی نمایش داده می‌شوند که اطمینان بالایی به دقت استنباط وجود داشته باشد.

<review>

حاوی مرور کاربر یا مرور سردبیر باشد. لازم نیست همه مرورهای فهرستگان را در عنصر <listing> خود بگنجانید. این عنصر برای این است که مرورهای انتخابی را که نشان‌دهنده ویژگی‌ها یا کیفیت این فهرستگان است اضافه کنید.

عنصر <review> در مکان زیر در سلسله‌مراتب XML فید «فهرست هتل» نشان داده می‌شود:

+ <listings>
    + <language>
    + <listing>
        + <content>
            + <review>

نحو

عنصر <review> از نحو زیر استفاده می‌کند:

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <content>
      ...
      <!-- Specify <review>'s child elements in the order shown below. -->
      <review type="editorial">
        <link>review_link</link>
        <title>review_title</title> <!-- Title is for reviews of type "editorial" only -->
        <author>review_author</author>
        <rating>review_rating</rating>
        <body>review_text</body>
        <date>review_date</date>
        <servicedate>review_servicedate</servicedate>
      </review>
      <review type="user">
        <link>review_link</link>
        <author>review_author</author>
        <date month="MM" day="DD" year="YYYY"/>  <!-- Date is for reviews of type "user" only -->
        <servicedate month="MM" day="DD" year="YYYY"/>  <!-- Service Date is for reviews of type "user" only -->
        <rating>review_rating</rating>
        <body>review_text</body>
      </review>
    </content>
  </listing>
</listings>

مشخصه‌ها

عنصر <review> دارای مشخصه‌های زیر است:

مشخصه الزامی است؟ شرح
type Required نوع بازبینی. روی یکی از مقادیر زیر تنظیم کنید:
  • editorial: مروری ازسوی وب‌سایت یا مرجع مرورگر دیگر.
  • ‫user: مروری از کاربر نهایی.

عناصر فرزند

عنصر <review> دارای عناصر فرزند زیر است:

عنصر فرزند الزامی است؟ نوع شرح
<link> Optional string پیوند به مرور. «http://‎» یا «https://‎» را در این عنصر اضافه کنید.
<title> Optional string (فقط مرورهای ویراستاری) عنوان مرور.
<author> Optional string نویسنده مرور؛ برای مثال، «Susan von Trapp». این نام همچنین می‌تواند نام وب‌سایت یا نشریه‌ای باشد که مرور در آن ظاهر می‌شود، اگر مرور بدون ذکر منبع باشد.
<rating> Optional string عدد ممیز شناور از ۰ تا ۱۰ (شامل) که نشان‌دهنده امتیاز مرور است. برای مثال، «8.9».
<body> Optional string نوشتار مرور. این عنصر نباید حاوی HTML باشد.
<date month="MM" day="DD" year="YYYY"/> Optional Object (فقط مرورهای کاربر) تاریخ مرور که با مشخصه‌های زیر برای این عنصر مشخص می‌کنید:
  • ‫day: روز ماه؛ برای مثال، «7».
  • month: ماه، که ۱ = ژانویه ... ۱۲ = دسامبر.
  • year: سال چهاررقمی؛ برای مثال، «۲۰۲۳».

برای مثال، ۷ ژوئن ۲۰۲۳ به‌صورت زیر نوشته می‌شود:

<date month="6" day="7" year="2023"/>
<servicedate month="MM" day="DD" year="YYYY"/> Optional Object (فقط مرورهای کاربر) تاریخی که مرورکننده از فهرستگان تحت مرور بازدید کرده است. قالب آن مانند <date> است.

برای مثال، ۷ ژوئن ۲۰۲۳ به‌صورت زیر نوشته می‌شود:

<servicedate month="6" day="7" year="2023"/>

مرورهایی که حداقل ماه و سال <servicedate> در آن‌ها تکمیل نشده باشد ممکن است نشان داده نشوند. روز الزامی نیست.

مثال

مثال زیر فهرست هتل جزئی را با فهرستی نشان می‌دهد که حاوی یک مرور سردبیری و یک مرور کاربر است:

<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.gstatic.com/localfeed/local_feed.xsd">
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>My Apartment</name>
    <address format="simple">
      <component name="addr1">1 Sandstone Building</component>
      <component name="city">Los Angeles</component>
      <component name="postal_code">90210</component>
      <component name="province">CA</component>
    </address>
    <country>US</country>
    <latitude>40.730610</latitude>
    <longitude>-73.935242</longitude>
    <phone type="main">12345678</phone>
    <category>hotel</category> <!-- You can use whatever property type categories you wish -->
    <content>
      <text type="description">
        <link>https://examplelisting.com/listings/12345</link>
        <title>3 bedrooms with ocean views</title>
        <body>Stay in this newly renovated 3BR house with ocean views.</body>
        <date month="7" day="23" year="2023"/>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE.COM</author>
        <rating>8</rating>
        <body>This place is really good.</body>
      </review>
      <review type="user">
        <link>https://exampleperson.org/reviews/82</link>
        <author>Susan von Trapp</author>
        <rating>6</rating>
        <body>Not a bad place, but I prefer to be closer to the beach.</body>
        <date day="6" month="7" year="2023"/>
        <servicedate day="16" month="6" year="2023"/>
      </review>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</client_attr>
        <client_attr name="num_reviews">14</client_attr>
      </attributes>
      <image type="photo" url="https://image_url">
        <link>https://image_url</link>
        <title>Main hotel picture</title>
      </image>
    </content>
  </listing>
  ...
</listings>

مقادیر جای‌بان attribute_name

جدول زیر فهرستی از مقادیر معتبر برای attribute_name در عنصر <client_attr name="attribute_name"> را ارائه می‌دهد؛ بااین‌حال، توصیه می‌شود که attribute_name اضافی خود را درصورت وجود ارائه دهید.

مقادیر attribute_name الزامی است؟ شرح مقادیر محتوای معتبر
capacity Required حداکثر تعداد مهمانانی که ملک می‌تواند در خود جای دهد. این مقدار باید برابر یا بیشتر از «number_of_bedrooms» باشد. Non-negative integer value
website Required نشانی وب‌سایت برای دارایی. این شناسه باید برای فهرستگان منحصربه‌فرد باشد و نباید در چندین فهرستگان تکرار شود. Free text
partner_hygiene_link Strongly recommended پیوند به سایت شریک خارجی که اطلاعات بیشتری درباره جزئیات بهداشتی فهرستگان ارائه می‌دهد. Free text (the site's URL)
number_of_bathrooms Strongly recommended تعداد حمام‌ها. Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms Strongly recommended تعداد اتاق خواب. Non-negative integer value
number_of_beds Strongly recommended تعداد تخت‌خواب‌ها در همه اتاق‌ها. Non-negative integer value
self_checkin_checkout Recommended اینکه آیا هتل امکان اعلام حضور و خروج خودکار را فراهم می‌کند یا نه. Yes/No/Unknown
rating Strongly recommended عدد نقطه شناوری که نشان‌دهنده رده‌بندی کلی ملک است. این عدد معمولاً از ۰ تا ۵، ۰ تا ۱۰، یا ۰ تا ۱۰۰ است، اما می‌توانید از هر دامنه‌ای که نشان‌دهنده سیستم رده‌بندی شما است استفاده کنید. Non-negative float value
rating_num Strongly recommended تعداد رده‌بندی‌هایی که ملک دارد. Non-negative integer value
rating_scale Strongly recommended حداکثر رده‌بندی ممکن برای دارایی. برای مثال، رده‌بندی ملک باید ۳ یا ۴ برای rating_scale‏ ۵ باشد.

توجه: rating_scale پیش‌فرض درصورت نامشخص بودن ۰-۱۰ است.

Non-negative integer value
instant_bookable Strongly recommended اینکه آیا ملک ازطریق فرایند تسویه‌حساب فوراً قابل‌رزرو است یا نه. گزینه جایگزین درانتظار تأیید است. Yes/No/Unknown
description Strongly recommended نوشتار آزاد که ویژگی‌های منحصربه‌فرد ملک را توصیف می‌کند Free text
category Strongly recommended نوع ملک، مانند ویلا، خانه ویلایی، کلبه، یا آپارتمان Free text
ac Recommended اینکه ملک تهویه مطبوع دارد یا نه. Yes/No/Unknown
beach_access Recommended آیا ملک به ساحل عمومی نزدیک به ملک دسترسی دارد. Yes/No/Unknown
check_in_time Recommended زمان دقیق روز برای اعلام حضور در ملک. قالب‌های HHMM،‏ HH:MM، یا HH:MM:SS پذیرفته می‌شود؛ برای مثال، به‌جای 2pm یا 2:00pm از 14:00 استفاده کنید. همه قالب‌های دیگر تجزیه یا نشان داده نخواهند شد. Time
check_out_time Recommended زمان دقیق تسویه‌حساب از ملک. قالب‌های HHMM،‏ HH:MM، یا HH:MM:SS پذیرفته می‌شود؛ برای مثال، به‌جای 11am یا 11:00am، از 11:00 استفاده کنید. همه قالب‌های دیگر تجزیه یا نشان داده نخواهند شد. Time
child_friendly Recommended اینکه آیا ملک برای کودکان مناسب است یا نه. Yes/No/Unknown
crib Recommended اینکه ملک تخت نوزاد ارائه می‌دهد یا نه. Yes/No/Unknown
elevator Recommended آیا ملک آسانسور دارد یا نه. Yes/No/Unknown
gym_fitness_equipment Recommended آیا ملک باشگاه یا وسایل تناسب اندام دارد یا نه. Yes/No/Unknown
heating Recommended اینکه ملک سیستم گرمایشی دارد یا نه. Yes/No/Unknown
hot_tub Recommended آیا ملک جکوزی دارد یا نه. Yes/No/Unknown
ironing_board Recommended اینکه هتل میز اتو دارد یا نه. Yes/No/Unknown
kitchen Recommended اینکه ملک آشپزخانه دارد یا نه. Yes/No/Unknown
microwave Recommended آیا ملک مایکروویو دارد. Yes/No/Unknown
min_days_advance_purchase Recommended حداقل تعداد روزهایی که ملک را می‌توان ازقبل رزرو کرد. Non-negative integer value
min_night_stay Recommended حداقل تعداد شب‌هایی که مهمان می‌تواند ملک را رزرو کند. Positive integer (more than zero)
max_night_stay Recommended حداکثر تعداد شب‌هایی که مهمان می‌تواند ملک را رزرو کند. Positive integer (more than zero)
outdoor_grill Recommended اینکه ملک منقل کباب‌پزی دارد یا نه. Yes/No/Unknown
oven_stove Recommended اینکه ملک اجاق گاز و/یا فر دارد یا نه. Yes/No/Unknown
parking_type Recommended نوع پارکینگ دردسترس در ملک. Free/Paid/None
patio Recommended اینکه ملک ایوان دارد یا نه. Yes/No/Unknown
pets_allowed Recommended برخی یا همه اتاق‌ها به مهمانان اجازه می‌دهند حیوانات خانگی (سگ یا گربه که حیوان خدمات‌رسان نیستند) را با خود بیاورند. Yes/No/Unknown
pool_type Recommended نوع استخری (دسترسی به استخر) که هتل دارد. Indoors, Outdoors, Indoors/Outdoors, None
room_type Recommended نوع اتاق. ENTIRE_PLACE تنها مقدار پشتیبانی‌شده است. ENTIRE_PLACE
smoking_free_property Recommended اینکه در ملک سیگار کشیدن ممنوع است یا نه. Yes/No/Unknown
special_service_level Recommended اینکه سطح خدمات فهرستگان به‌نوعی خاص است یا نه. برای مثال، verified، luxury، premium Yes/No/Unknown
square_footage Recommended مساحت ملک به فوت مربع. Non-negative float value
square_meters Recommended مساحت ملک به متر مربع. Non-negative float
tv Recommended اینکه ملک تلویزیون دارد یا نه. Yes/No/Unknown
washer_dryer Recommended آیا ملک وسایل لباسشویی دارد یا نه. Yes/No/Unknown
wheelchair_accessible Recommended اینکه ملک برای صندلی چرخدار دسترس‌پذیر است یا نه. Yes/No/Unknown
internet_type Recommended نوع دسترسی به اینترنت Wi-Fi که ملک ارائه می‌دهد. Free/Paid/None
airport_shuttle Optional اینکه آیا میزبان حمل‌ونقل به یا از فرودگاه یا سایر پایانه‌ها را ارائه می‌دهد یا نه. Yes/No/Unknown
balcony Optional آیا ملک بالکن دارد یا نه. Yes/No/Unknown
fire_place Optional اینکه ملک شومینه دارد یا نه. Yes/No/Unknown
free_breakfast Optional اینکه آیا صبحانه رایگان در هزینه اقامتگاه گنجانده شده است یا نه. Yes/No/Unknown
host_description Optional شرح میزبان اقامتگاه اجاره‌ای. Free text
host_language Optional زبان‌هایی که میزبان می‌تواند صحبت کند. فهرست جداشده با کاما از کدهای زبان؛ برای مثال: de، en
host_name Optional نام میزبان اقامتگاه اجاره‌ای. Free text
host_response_rate Optional میانگین نرخ پاسخ‌دهی میزبان. Non-negative float value, for example, 1, 0.75, 0.5
host_response_time Optional میانگین زمان پاسخ‌دهی میزبان. Free text
license_num Optional شماره پروانه (گردشگری یا کسب‌وکار) که باید برای املاک در مناطق خاصی از جهان نشان داده شود. این مورد می‌تواند تکرار شود و اگر چندین پروانه وجود دارد، پیشنهاد می‌کنیم مرجع پروانه را به‌عنوان بافت اضافه کنید؛ برای مثال: «پاریس: 123456ABC». Free text
number_of_half_bathrooms Optional تعداد نیم‌حمام‌ها. Non-negative integer value
number_of_living_rooms Optional تعداد اتاق‌های نشیمن. Non-negative integer value
private_beach_access Optional آیا هتل دسترسی اختصاصی به ساحل غیرعمومی دارد. Yes/No/Unknown
refund_policy Optional خط‌مشی استرداد مبلغ برای ملک. Free text

عناصر فرزند XML

عناصر فرزند XML زیر الزامی هستند:

عنصر فرزند الزامی است؟ نوع شرح
<country> Strongly recommended string کشوری که این فهرستگان در آن قرار دارد. مقدار باید کد کشور ۲ حرفی ISO 3116 باشد؛ برای مثال، ایالات متحده US و کانادا CA است:
    <country>US</country>
<id> Required string شناسه یکتای دارایی. توجه داشته باشید که هر اقامتگاه اجاره‌ای باید شناسه‌ای داشته باشد که برای سایت شما یکتا باشد و این شناسه هرگز نباید دوباره استفاده شود.
<latitude> Required float عرض جغرافیایی مربوط به مکان فهرستگان. برای مثال:
    <latitude>37.423738</latitude>

این مقدار را می‌توان با ابزارهای زمین‌کدیابی مثل Google Maps API تولید کرد.

<longitude> Required float طول جغرافیایی که با مکان فهرستگان مطابقت دارد. برای مثال:
    <longitude>-122.090101</longitude>

این مقدار را می‌توان با ابزارهای زمین‌کدیابی مثل Google Maps API تولید کرد.

<name> Required string نام دارایی. حداکثر ۳۰۰ نویسه.
<address> Required string or Object

مکان فیزیکی کامل ملک به‌صورت رشته. نشانی باید شامل نام و شماره خیابان باشد. اگر هیچ‌کدام وجود ندارد، نشانی باید شامل plus code باشد. شماره آپارتمان یا واحد نیز باید درصورت وجود اضافه شود.

یا می‌توانید نشانی «ترکیبی» ارائه دهید. از عناصر فرزند <component> برای توصیف هریک از بخش‌های زیر در نشانی استفاده کنید:

  • ‫addr1: نشانی خیابان اصلی.
  • ‫addr2: درصورت لزوم، نشانی خیابان فرعی، ازجمله شماره واحد.
  • ‫city: شهر.
  • province: درصورت لزوم، ایالت، منطقه، یا استان.
  • postal_code: کد پستی.
  • ‫country: کشور.

توجه داشته باشید که صندوق‌های پستی یا دیگر نشانی‌های مخصوص ارسال پستی، نشانی فیزیکی کامل محسوب نمی‌شوند.

در اینجا نمونه‌هایی از نشانی کامل آورده شده است:

<address>6 Acacia Ave Apt. 2, Nottingham NG8 6FT, UK/address>
<address>
  <component name="addr1">6 Acacia Ave</component>
  <component name="addr2">Apt. 2</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

در اینجا نمونه‌هایی از نشانی کامل بااستفاده از plus code آورده شده است:

<address>XQHM+7VF Nottingham NG8 6FT, UK/address>
<address>
  <component name="addr1">XQHM+7VF</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

از موارد زیر اجتناب کنید:

  • اطلاعات زائد: اطلاعات نامربوط را اضافه نکنید یا بخش‌های نشانی را تکرار نکنید.
  • نشانی خیابان ثبت نشده است: نشانی‌ها باید نام و شماره خیابان داشته باشند.

نمونه فهرستگان «اقامتگاه‌های اجاره‌ای»

<?xml version="1.0" encoding="UTF-8"?>
<listings>
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>Apartment Name</name>
    <address format="simple">
      <component name="addr1">18733 Clark Way</component>
      <component name="addr2">#C10</component>
      <component name="city">Mountain View</component>
      <component name="postal_code">94043</component>
      <component name="province">California</component>
    </address>
    <country>US</country>
    <latitude>37.4182515</latitude>
    <longitude>-122.0742354</longitude>
    <phone type="main">12345678</phone>
    <category>vacation_villa</category>
    <date day="21" month="12" year="2017"/>
    <content>
      <text type="description">
        <link>https://list_url</link>
        <title>Description Title</title>
        <body>Description Body</body>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE</author>
        <rating>8</rating>
        <body>This place is really good.</body>
      </review>
      <review type="user">
        <link>https://exampleperson.org/reviews/82</link>
        <author>Susan von Trapp</author>
        <rating>6</rating>
        <body>Not a bad place, but I prefer to be closer to the beach.</body>
        <date day="6" month="7" year="2017"/>
        <servicedate day="16" month="6" year="2017"/>
      </review>
      <attributes>
        <website>https://hotel.example.com/123456</website>
        <client_attr name="capacity">7</client_attr>
        <client_attr name="cleaning_disinfection">Yes</client_attr>
        <client_attr name="min_days_between_stays">3</client_attr>
        <client_attr name="enhanced_cleaning_practices">Yes</client_attr>
        <client_attr name="partner_hygiene_link">http://www.example.com/hygiene/</client_attr>
        <client_attr name="number_of_bathrooms">2</client_attr>
        <client_attr name="number_of_bedrooms">3</client_attr>
        <client_attr name="number_of_beds">4</client_attr>
        <client_attr name="self_checkin_checkout">Yes</client_attr>
        <client_attr name="rating">4.8</client_attr>
        <client_attr name="rating_num">5373</client_attr>
        <client_attr name="rating_scale">5</client_attr>
        <client_attr name="ac">Yes</client_attr>
        <client_attr name="airport_shuttle">Yes</client_attr>
        <client_attr name="balcony">No</client_attr>
        <client_attr name="beach_access">Yes</client_attr>
        <client_attr name="check_in_time">15:00</client_attr>
        <client_attr name="check_out_time">11:00</client_attr>
        <client_attr name="child_friendly">Yes</client_attr>
        <client_attr name="crib">Unknown</client_attr>
        <client_attr name="elevator">Yes</client_attr>
        <client_attr name="fire_place">Unknown</client_attr>
        <client_attr name="free_breakfast">Yes</client_attr>
        <client_attr name="gym_fitness_equipment">Yes</client_attr>
        <client_attr name="heating">Yes</client_attr>
        <client_attr name="host_description">A short description about the host and their interests</client_attr>
        <client_attr name="host_name">The name of the host</client_attr>
        <client_attr name="host_language">en, da, el</client_attr>
        <client_attr name="host_response_rate">0.75</client_attr>
        <client_attr name="host_response_time">1 hour</client_attr>
        <client_attr name="hot_tub">Yes</client_attr>
        <client_attr name="instant_bookable">Yes</client_attr>
        <client_attr name="internet_type">Free</client_attr>
        <client_attr name="ironing_board">No</client_attr>
        <client_attr name="kitchen">Yes</client_attr>
        <client_attr name="license_num">Free text. If multiple licenses exist, we suggest adding authority of the licence as context</client_attr>
        <client_attr name="license_num">Paris: 123456ABC</client_attr>
        <client_attr name="microwave">Yes</client_attr>
        <client_attr name="max_night_stay">7</client_attr>
        <client_attr name="min_days_advance_purchase">2</client_attr>
        <client_attr name="min_night_stay">3</client_attr>
        <client_attr name="number_of_living_rooms">1</client_attr>
        <client_attr name="outdoor_grill">No</client_attr>
        <client_attr name="oven_stove">Yes</client_attr>
        <client_attr name="parking_type">Free</client_attr>
        <client_attr name="patio">Unknown</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="pool_type">Indoors</client_attr>
        <client_attr name="private_beach_access">Unknown</client_attr>
        <client_attr name="room_type">ENTIRE_PLACE</client_attr>
        <client_attr name="refund_policy">The refund policy for the property</client_attr>
        <client_attr name="smoking_free_property">Yes</client_attr>
        <client_attr name="special_service_level">No</client_attr>
        <client_attr name="square_footage">1200</client_attr>
        <client_attr name="tv">Yes</client_attr>
        <client_attr name="washer_dryer">Yes</client_attr>
        <client_attr name="wheelchair_accessible">Yes</client_attr>
      </attributes>
    </content>
  </listing>
</listings>