این صفحه توضیحات، مقادیر و الزامات مربوط به ویژگی‌ها و عناصر فرزند را پوشش می‌دهد. این مقادیر فقط برای املاک Vacation Rentals قابل استفاده هستند.
ساختار کلی XML فرمتی مشابه فیدهای فهرست هتل دارد. به مرجع XML فهرست هتل مراجعه کنید.
عدم درج موارد الزامی زیر، فهرست را به طور خودکار غیرفعال می‌کند:
- عناصر فرزند XML مورد نیاز:
id،name،latitude،longitude،address. - ویژگی‌های مورد نیاز:
capacityوwebsite. به لینک‌های مستقیم Vacation Rentals در فید آگهی خود مراجعه کنید. این به کاربران این امکان را می‌دهد که از وب‌سایت ملک بازدید کنند.
برای جزئیات عناصر فرزند XML مورد نیاز، به عناصر فرزند XML مراجعه کنید.
برای اطلاعات بیشتر در مورد اجاره‌های تعطیلات، به ویژگی‌های منحصر به فرد اجاره‌های تعطیلات مراجعه کنید.
در نهایت، وقتی گوگل از منابع دیگر تشخیص می‌دهد که مقدار یک ویژگی با آنچه در فید یک آگهی اجاره خانه برای تعطیلات مشخص شده است، متفاوت است، مقدار آن آگهی را نمایش می‌دهد. برای مثال، اگر گوگل از روی عکس‌های یک آگهی تشخیص دهد که آن آگهی آشپزخانه دارد، اما ویژگی kitchen وجود ندارد یا روی No تنظیم شده است، گوگل آن آگهی را دارای آشپزخانه در نظر می‌گیرد. این ویژگی‌ها «ویژگی‌های استنباطی» نامیده می‌شوند و فقط زمانی نمایش داده می‌شوند که اطمینان بالایی به دقت استنباط وجود داشته باشد.
<review>
شامل یک نظر کاربر یا یک نظر ویراستاری است. لازم نیست همه نظرات مربوط به یک آگهی را در عنصر <listing> خود قرار دهید. این عنصر برای شما در نظر گرفته شده است تا نظرات منتخبی را که نشان‌دهنده ویژگی‌ها یا کیفیت این آگهی هستند، در آن قرار دهید.
عنصر <review> در سلسله مراتب XML مربوط به Hotel List Feed در مکان زیر ظاهر می‌شود:
+ <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 | نوع بررسی. روی یکی از مقادیر زیر تنظیم شود:
|
عناصر فرزند
عنصر <review> دارای عناصر فرزند زیر است:
| عنصر فرزند | الزامی است؟ | نوع | توضیحات |
|---|---|---|---|
| <link> | Optional | string | پیوندی به نقد. در این عنصر از "http://" یا "https://" استفاده کنید. |
| <title> | Optional | string | (فقط نقدهای سرمقاله‌ای) عنوان نقد. |
| <author> | Optional | string | نویسنده نقد؛ برای مثال، «سوزان فون تراپ». این همچنین می‌تواند نام وب‌سایت یا نشریه‌ای باشد که نقد در آن منتشر می‌شود، البته اگر نام نویسنده ذکر نشده باشد. |
| <rating> | Optional | string | یک عدد اعشاری از ۰ تا ۱۰ (شامل) که امتیاز بررسی را نشان می‌دهد. برای مثال، "۸.۹". |
| <body> | Optional | string | متن نقد. این عنصر نباید حاوی HTML باشد. |
| <date month=" MM " day=" DD " year=" YYYY "/> | Optional | Object | (فقط نقدهای کاربران) تاریخ نقد، که شما با ویژگی‌های زیر از این عنصر مشخص می‌کنید:
برای مثال، ۷ ژوئن ۲۰۲۳ به صورت زیر نوشته می‌شود: <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 | حداکثر تعداد مهمانانی که ملک می‌تواند در خود جای دهد. این مقدار باید برابر یا بیشتر از "تعداد_اتاق_خواب" باشد. | 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 پذیرفته می‌شود؛ برای مثال، به جای ۲ بعد از ظهر یا ۲:۰۰ بعد از ظهر از ۱۴:۰۰ استفاده کنید. سایر قالب‌ها تجزیه یا نمایش داده نمی‌شوند. | Time |
| check_out_time | Recommended | زمان دقیق روز برای خروج از ملک. قالب HHMM، HH:MM یا HH:MM:SS پذیرفته می‌شود؛ برای مثال، به جای ۱۱ صبح یا ۱۱:۰۰ صبح از ۱۱:۰۰ استفاده کنید. سایر قالب‌ها تجزیه یا نمایش داده نمی‌شوند. | 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 | نوع دسترسی به اینترنت وای فای ارائه شده توسط ملک. | 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 | نام ملک. حداکثر ۳۰۰ کاراکتر. |
| <address> | Required | string or Object | موقعیت فیزیکی کامل ملک به صورت رشته‌ای. آدرس باید شامل نام خیابان و شماره آن باشد. در صورت وجود، آدرس باید شامل یک کد پلاس باشد. در صورت لزوم، شماره آپارتمان یا واحد نیز باید درج شود. به عنوان یک روش جایگزین، می‌توانید یک آدرس "ترکیبی" ارائه دهید. از عناصر فرزند
توجه داشته باشید که صندوق‌های پستی یا سایر آدرس‌های پستی، آدرس‌های فیزیکی کامل محسوب نمی‌شوند. در اینجا نمونه‌هایی از یک آدرس کامل آورده شده است: <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> در اینجا نمونه‌هایی از یک آدرس کامل با استفاده از کد پلاس آورده شده است: <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>