این صفحه شرح، مقادیر، و الزامات مشخصهها و عناصر فرزند را پوشش میدهد. این مقادیر فقط برای داراییهای «اقامتگاههای اجارهای» قابل اعمال است.
ساختار کلی 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 | نوع بازبینی. روی یکی از مقادیر زیر تنظیم کنید:
|
عناصر فرزند
عنصر <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 | (فقط مرورهای کاربر) تاریخ مرور که با مشخصههای زیر برای این عنصر مشخص میکنید:
برای مثال، ۷ ژوئن ۲۰۲۳ بهصورت زیر نوشته میشود: <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 باشد. شماره آپارتمان یا واحد نیز باید درصورت وجود اضافه شود. یا میتوانید نشانی «ترکیبی» ارائه دهید. از عناصر فرزند
توجه داشته باشید که صندوقهای پستی یا دیگر نشانیهای مخصوص ارسال پستی، نشانی فیزیکی کامل محسوب نمیشوند. در اینجا نمونههایی از نشانی کامل آورده شده است: <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>