این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

ویژگی های

این صفحه توضیحات، مقادیر و الزامات ویژگی ها و عناصر فرزند را پوشش می دهد. این مقادیر فقط برای املاک Vacation Rentals قابل اعمال است.

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

عدم درج موارد مورد نیاز زیر به طور خودکار فهرست را غیرفعال می کند.

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

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

برای اطلاعات بیشتر در مورد اجاره تعطیلات، به ویژگی های منحصر به فرد برای اجاره تعطیلات مراجعه کنید.

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

مقادیر برای مکان نگهدار ویژگی_name

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

مقادیر `attribute_name`	ضروری؟	شرح	مقادیر محتوای معتبر
capacity	Required	حداکثر تعداد مهمانانی که ملک می تواند در خود جای دهد. این مقدار باید برابر یا بیشتر از "تعداد_خواب_ها" باشد.	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	یک عدد ممیز شناور که نشان دهنده رتبه بندی اموال کل است. این عدد معمولاً از 0-5، 0-10 یا 0-100 است، اما شما می توانید از هر محدوده ای که نشان دهنده سیستم رتبه بندی شما باشد استفاده کنید.	Non-negative float value
rating_num	Strongly recommended	تعداد رتبه هایی که ملک دارد.	Non-negative integer value
rating_scale	Strongly recommended	حداکثر امتیاز ممکن برای یک ملک	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 پذیرفته شد. به عنوان مثال، به جای 2 بعدازظهر یا 14:00 از ساعت 14:00 استفاده کنید. همه قالب‌های دیگر تجزیه یا نمایش داده نمی‌شوند.	Time
check_out_time	Recommended	زمان دقیق روز برای خروج از ملک. قالب HHMM، HH:MM، یا HH:MM:SS پذیرفته شد. به عنوان مثال، به جای 11 صبح یا 11:00 از ساعت 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
minimum_days_advance_purchase	Recommended	حداقل تعداد روزهای قبل که می توان ملک را رزرو کرد.	Non-negative integer value
minimum_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
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> این مقدار را می توان با ابزارهای GeoCoding مانند Google Maps API ایجاد کرد.
<longitude>	Required	float	طول جغرافیایی که با مکان فهرست مطابقت دارد. به عنوان مثال: <longitude>-122.090101</longitude> این مقدار را می توان با ابزارهای GeoCoding مانند Google Maps API ایجاد کرد.
<name>	Required	string	نام ملک. حداکثر 300 کاراکتر.
<address>	Required	Object or string	موقعیت فیزیکی کامل ملک. این عنصر یک ویژگی واحد دارد، `format` ، که باید آن را روی `simple` تنظیم کنید. حداقل باید آدرس خیابان، شهر، ایالت یا منطقه و کد پستی ملک را ارائه دهید. از عناصر فرزند `<component>` برای توصیف هر یک از بخش های زیر از آدرس استفاده کنید: `addr1` : آدرس خیابان اصلی ملک. `addr2` : نشانی خیابان ثانویه، در صورت لزوم شامل شماره واحد. `addr3` : بخش سوم از آدرس خیابان. `city` : نام شهر ملک. `province` : نام ایالت، منطقه یا استان ملک. `postal_code` : کد پستی ملک. مثلا: <address format="simple"> <component name="addr1">6 Acacia Ave</component> <component name="addr2">Floor 5</component> <component name="city">London</component> <component name="province">Greater London</component> <component name="postal_code">SW1W 9TQ</component> </address> از طرف دیگر، می‌توانید یک آدرس «رایگان» ارائه دهید، اگرچه این توصیه نمی‌شود. مثلا: <address>6 Elm Ave Unit 3, Boston, MA, 02472</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="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="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="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="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="smoking_free_property">Yes</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>