فهرست هتل یک یا چند فایل XML است که تمام هتلهایی را که اطلاعات قیمت آنها را ارائه میکنید فهرست میکند. فایل لیست هتل خود حاوی اطلاعات قیمت نیست.
عنصر اصلی لیست هتل، عنصر <listings>
است که حاوی عناصر <listing>
است که خواص شما را توصیف می کند.
شما یک لیست هتل را به عنوان بخشی از پیاده سازی اولیه خود ایجاد می کنید و سپس هتل ها را به عنوان بخشی از تعمیر و نگهداری منظم از آن اضافه یا حذف می کنید.
مطمئن شوید که فایل های شما مطابق دستورالعمل های نحوی هستند. به عنوان مثال، از رمزگذاری UTF-8 استفاده کنید و این طرح رمزگذاری را با گنجاندن ویژگی encoding
در تگ XML خود مشخص کنید.
پس از ایجاد لیست هتل، میتوانید آن را بهصورت دستی با استفاده از Hotel Center در Google آپلود کنید یا آن را روی سرور خود میزبانی کنید .
مشکلات داده را پیدا و برطرف کنید
برای یافتن و رفع مشکلات داده در لیست هتل خود، به مقالات زیر مراجعه کنید:
الزامات فهرست
برای واجد شرایط بودن برای تبلیغات هتل گوگل، یک ملک در لیست هتل شما باید دارای موارد زیر باشد:
- اتاق هایی که میهمانان پولی می توانند در آنها اقامت کنند
- حضور فیزیکی و مکان ثابتی که برای عموم آزاد است
- دیوارهای ثابت و لوله کشی
- حداقل نیاز به اقامت بیش از 7 روز نیست
نمونههای متداول املاک غیرقابل صلاحیت شامل سفرهای دریایی و آپارتمانها است زیرا معمولاً معیارهای Listing requirements
برآورده نمیکنند.
کابینهای کمپینگ و سایر مکانهای کمپینگ با دیوارهای ثابت، لولهکشی و کنترل آب و هوا (از جمله اجاقهای چوبی یا بخاریهای پروپان) واجد شرایط هستند. اقامتگاه های فضای باز که واجد شرایط نیستند عبارتند از:
- کمپینگ، جایی که مهمانان در چادر اقامت می کنند
- پارکهای RV، جایی که مهمانان RV خود را میآورند
<listings>
<listings>
عنصر اصلی یک لیست هتل است و حاوی یک عنصر <language>
و حداقل یک <listing>
است.
عنصر <listings>
در مکان زیر در سلسله مراتب XML لیست هتل ظاهر می شود:
+ <listings>
+ <language>
+ <datum>
+ <listing>
نحو
عنصر <listings>
از نحو زیر استفاده می کند:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="xsi"
xsi:noNamespaceSchemaLocation="schema_xsd">
<language> language_code</language>
<datum> datum_code </datum>
<listing> listing</listing>
...
</listings>
صفات
عنصر <listings>
دارای ویژگی های زیر است:
صفت | مورد نیاز؟ | توضیحات |
---|---|---|
xmlns:xsi | مورد نیاز | روی http://www.w3.org/2001/XMLSchema-instance تنظیم کنید. |
xsi:noNamespaceSchemaLocation | مورد نیاز | روی http://www.gstatic.com/localfeed/local_feed.xsd تنظیم کنید. |
عناصر کودک
عنصر <listings>
دارای عناصر فرزند زیر است:
عنصر کودک | مورد نیاز؟ | تایپ کنید | توضیحات |
---|---|---|---|
<language> | Required | string | زبانی که فید شما به آن نوشته شده است. مقدار این عنصر را روی یک کد زبان دو حرفی تنظیم کنید. به عنوان مثال، en برای انگلیسی. |
<datum> | Optional | enum | این عنصر مبدأ ژئودزیکی یا مدل مرجع مختصات طول و عرض جغرافیایی ارائه شده در خوراک را مشخص می کند. اگر مقدار مبنا ارائه نشود، مقدار پیشفرض این عنصر WGS84 است که توسط اکثر دستگاههای GPS مدرن استفاده میشود. داده توکیو فقط برای آدرس های ژاپن قابل اجرا است.مقادیر معتبر برای این عنصر عبارتند از:
WGS84 ، عنصر <datum> را در لیست هتل وارد نکنید. |
<listing> | Required | <listing> | یک یا چند ورودی که هر هتل را در فید توصیف می کند. توجه داشته باشید که هر هتل در لیست باید دارای یک شناسه منحصر به فرد برای سایت شما باشد و این شناسه هرگز نباید دوباره استفاده شود. |
نمونه ها
آدرس ساختاریافته
مثال زیر یک لیست جزئی هتل را با یک آدرس ساختاریافته نشان می دهد:
<?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>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<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>
<country>GB</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
آدرس فرم آزاد
مثال زیر یک لیست جزئی هتل را با یک آدرس رایگان نشان می دهد:
<?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>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<address>6 Elm Ave Unit 3, Boston, MA, 02472</address>
<country>US</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
محتوای اختیاری
مثال زیر یک لیست جزئی هتل را با فهرستی نشان می دهد که حاوی یک <content>
اختیاری است:
<?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>
<listing>
تعریف هتل در عنصر <listings>
فهرست هتل.
عنصر <listing>
در مکان زیر در سلسله مراتب XML Feed List Hotel ظاهر می شود:
+ <listings>
+ <language>
+ <listing>
نحو
عنصر <listing>
از نحو زیر استفاده می کند:
<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
<listing>
<!-- Specify <listing>'s child elements in the order shown below. -->
<id>hotel_ID</id>
<name>hotel_name</name>
<address>
<component name="addr1">street_address_1</component>
<component name="addr2">street_address_2</component>
<component name="city">city_name</component>
<component name="province">province_name</component>
<component name="postal_code">postal_code</component>
</address>
<!-- You can also define an address freeform, although this is not recommended: -->
<!-- <address>freeform_address</address> -->
<country>country_code</country>
<latitude>hotel_latitude</latitude>
<longitude>hotel_longitude</longitude>
<phone type="[fax|main|mobile|tdd|tollfree]">phone_number</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
<content>content</content>
</listing>
</listings>
صفات
عنصر <listing>
هیچ ویژگی ندارد.
عناصر کودک
عنصر <listing>
دارای عناصر فرزند زیر است:
عنصر کودک | مورد نیاز؟ | تایپ کنید | توضیحات |
---|---|---|---|
<id> | Required | string | یک شناسه منحصر به فرد برای هتل. توجه: این مقدار باید برای همیشه برای سایت شما منحصر به فرد باشد. از شناسهها استفاده مجدد نکنید ، زیرا ممکن است هنگام تلاش برای حل مشکلات تطبیق دارایی، مشکل ایجاد کند. |
<name> | Required | string | نام هتل. به عنوان مثال: <name>Belgrave House</name> |
<address> | Required | Object or string | موقعیت فیزیکی کامل هتل. این عنصر یک ویژگی واحد به حداقل باید آدرس خیابان، شهر، ایالت یا منطقه و کد پستی هتل را ارائه دهید. از عناصر فرزند
به عنوان مثال: <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> توجه داشته باشید که صندوقهای پستی یا سایر آدرسهای فقط پستی، آدرسهای فیزیکی کامل در نظر گرفته نمیشوند. |
<country> | Required | string | کشوری که این فهرست در آن قرار دارد. مقدار باید یک کد کشور دو حرفی باشد. برای مثال، ایالات متحده "US" و کانادا "CA" است. به عنوان مثال: <country>US</country> |
<latitude> | Required* | float | عرض جغرافیایی که با مکان فهرست مطابقت دارد. به عنوان مثال: <latitude>37.423738</latitude> این مقدار را می توان با ابزارهای GeoCoding مانند Google Maps API ایجاد کرد. |
<longitude> | Required* | float | طول جغرافیایی که با مکان فهرست مطابقت دارد. به عنوان مثال: <longitude>-122.090101</longitude> این مقدار را می توان با ابزارهای GeoCoding مانند Google Maps API ایجاد کرد. |
<location_precision> | Optional | integer | زمانی که طول و عرض جغرافیایی ملک مبهم باشد، دقت موقعیت ملک بر حسب متر ارسال می شود. صفر (0) به این معنی است که هیچ ابهامی وجود ندارد و مکان دقیق آن است. توجه: این عنصر فقط برای اجاره تعطیلات اعمال می شود. |
<phone> | Required* | string | یک یا چند شماره تماس برای هتل. اگر فهرست شعبه تجاری است، لطفاً شماره تلفن مخصوص محل شعبه (نه شماره تلفن دفتر مرکزی) را ارائه دهید. ویژگی
به عنوان مثال: <!-- Singapore (country code +65) --> <phone type="main">+65 6722-2323</phone> <!-- U.S. (country code +1) --> <phone type="fax">+1 408-555-1111</phone> حداقل باید یک نوع |
<category> | Optional | string | نوع ملک مانند هتل. شرکا ممکن است از هر دسته بندی داخلی که دارند برای توصیف دارایی خود استفاده کنند، مانند "هتل های تجاری"، "مرکز استراحتگاه ها"، "متل ها" و موارد مشابه. |
<content> | Optional | <content> | جزئیات اختیاری مورد استفاده برای فهرست، مانند توضیحات، رتبهبندی و ویژگیهای ملک. |
* شماره تلفن یا طول و عرض جغرافیایی لازم است. توصیه می کنیم هر دو را تعریف کنید.
نمونه ها
آدرس ساختاریافته
مثال زیر یک لیست جزئی هتل را با یک آدرس ساختاریافته نشان می دهد:
<?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>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<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>
<country>GB</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
آدرس فرم آزاد
مثال زیر یک لیست جزئی هتل را با یک آدرس رایگان نشان می دهد:
<?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>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<address>6 Elm Ave Unit 3, Boston, MA, 02472</address>
<country>US</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
محتوای اختیاری
مثال زیر یک لیست جزئی هتل را با فهرستی نشان می دهد که حاوی یک <content>
اختیاری است:
<?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>
<content>
اطلاعاتی در مورد یک فهرست، مانند رتبهبندیها و نظرات، امکانات رفاهی و جزئیات دیگر اضافه میکند. عنصر <content>
اختیاری است. در <content>
، همه عناصر فرزند اختیاری هستند.
عنصر <content>
در مکان زیر در سلسله مراتب XML Feed List Hotel ظاهر می شود:
+ <listings>
+ <language>
+ <listing>
+ <content>
نحو
عنصر <content>
از نحو زیر استفاده می کند:
<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
<listing>
<content>
<!-- Specify <text>'s child elements in the order shown below. -->
<text type="description">
<link>listing_link</link>
<title>listing_title</title>
<author>listing_author</author>
<body>listing_description</body>
<date month="MM" day="DD" year="YYYY"/>
</text>
<!-- 0 or more reviews: -->
<review type="[editorial|user]">
...
</review>
<!-- 0 or more attributes: -->
<attributes>
<website>https://hotel.example.com</website>
<client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
<client_attr name="custom_0">custom_attribute_0</client_attr>
<client_attr name="custom_1">custom_attribute_1</client_attr>
<client_attr name="custom_2">custom_attribute_2</client_attr>
<client_attr name="custom_3">custom_attribute_3</client_attr>
<client_attr name="custom_4">custom_attribute_4</client_attr>
<client_attr name="hotel_brand">hotel_brand</client_attr>
<client_attr name="num_reviews">number_of_reviews</client_attr>
<client_attr name="rating">aggregate_rating</client_attr>
</attributes>
<!-- a picture of the hotel or property-->
<image type="photo" url="https://image_url">
<link>https://image_url</link>
<title>Main Hotel Picture</title>
</image>
</content>
</listing>
...
</listings>
صفات
عنصر <content>
هیچ ویژگی ندارد.
عناصر کودک
عنصر <content>
دارای عناصر فرزند زیر است:
عنصر کودک | مورد نیاز؟ | تایپ کنید | توضیحات |
---|---|---|---|
<text type= "description"> | Optional | Object | صفحه وب مرتبط با فهرست ارائه دهنده. دارای عناصر کودک زیر است:
توجه : این عناصر باید به ترتیب بالا ظاهر شوند. |
<review type= "[editorial| user]"> | Optional | <review> | شامل یک بررسی کاربر یا یک بررسی سرمقاله از فهرست است. فهرست شما میتواند دارای هر تعداد نظر از هر نوع باشد. لازم نیست همه بررسیهای یک ویژگی را در عنصر |
<attributes> | Optional | Object | حاوی 0 یا بیشتر <client_attr name="attribute_name">attribute_value<client_attr> برای فهرست و توضیح عناصر فرزند، به همه عناصر اگر عنصر فرزند |
<image> | Optional | Object | برچسب تکرار شده، حاوی اطلاعات دقیق تصویر است. |
مثال
مثال زیر یک لیست هتل جزئی را نشان می دهد که شامل عنصر <content>
است:
<?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>
<review>
شامل یک بررسی کاربر یا یک بررسی سرمقاله است. نیازی نیست تمام نظرات یک فهرست را در عنصر <listing>
خود قرار دهید. این عنصر برای شما در نظر گرفته شده است که نظرات منتخبی را که نشانگر ویژگیها یا کیفیت این فهرست هستند را شامل شود.
عنصر <review>
در مکان زیر در سلسله مراتب XML Feed List Hotel ظاهر می شود:
+ <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 | یک عدد ممیز شناور از 0 تا 10 (شامل) که نشان دهنده امتیاز بررسی است. به عنوان مثال، "8.9". |
<body> | Optional | string | متن بررسی. این عنصر نباید حاوی HTML باشد. |
<date month=" MM " day=" DD " year=" YYYY "/> | Optional | Object | (فقط نظرات کاربران) تاریخ بررسی که با ویژگی های زیر این عنصر را مشخص می کنید:
به عنوان مثال، 7 ژوئن 2023 به صورت زیر نوشته شده است: <date month="6" day="7" year="2023"/> |
<servicedate month=" MM " day=" DD " year=" YYYY "/> | Optional | Object | (فقط نظرات کاربران) تاریخی که بازبین از فهرست در حال بررسی بازدید کرده است. قالب همان <date> بالا است. به عنوان مثال، 7 ژوئن 2023 به صورت زیر نوشته شده است: <servicedate month="6" day="7" year="2023"/> نظرات بدون حداقل ماه و سال <servicedate> ممکن است نشان داده نشوند. روز لازم نیست. |
توجه داشته باشید که <title>
تنها در صورتی یک عنصر فرزند معتبر <review>
است که type
بررسی editorial
باشد و <date>
فقط در صورتی معتبر است که type
user
باشد.
مثال
مثال زیر یک لیست هتل جزئی را با فهرستی که حاوی سرمقاله و نظر کاربر است نشان می دهد:
<?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>
<attributes>
تگ <attributes>
می تواند برای توصیف امکانات رفاهی و طبقه بندی رتبه بندی ها و بررسی های ملک استفاده شود.
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
عناصر کودک
عنصر کودک | مورد نیاز؟ | توضیحات | |
---|---|---|---|
<website> | Optional | وب سایت اصلی هتل در صورت وجود، باید قبل از اولین عنصر <client_attr> قرار گیرد. مثال: <website>https://hotel.example.com</website> | |
<client_attr name=" attribute_name "> | Optional | یک مشخصه یا "ویژگی" اضافی از ویژگی که می تواند با استفاده از attribute_name یا attribute_name پشتیبانی شده برای اجاره تعطیلات مشخص شود. |
مقادیر برای مکان نگهدار ویژگی_name
جدول زیر مقادیر معتبر attribute_name را در عنصر <client_attr name=" attribute_name "> فهرست میکند.
مقادیر attribute_name | توضیحات | مقادیر محتوای معتبر |
---|---|---|
alternate_hotel_id | یک شناسه جایگزین برای ملک شما داشتن شناسههای جداگانه مفید است اگر ممکن است به یک شناسه دارایی برای اطلاعات فید خود و یک شناسه ملک دیگر برای موتور رزرو خود نیاز داشته باشید. | هر مقدار رشته |
custom_[0-4] | هر نوع رشته ای از ویژگی های سفارشی. این ها به کاربران نمایش داده نمی شوند. | هر مقدار رشته |
hotel_brand | برندی که این هتل به آن تعلق دارد. مثلاً «ماریوت» یا «هیلتون». این برای کاربران نمایش داده نمی شود، اما می توان از آن برای گروه بندی هتل ها استفاده کرد. | هر مقدار رشته |
lodging | نمایش کدگذاری شده از تمام فیلدهای موجود در پروتوی Lodging . | رشته کدگذاری شده با Base64 از پروتکل Lodging کدگذاری شده |
num_reviews | تعداد بررسی های لیست | هر عدد صحیح غیر منفی |
rating | یک عدد ممیز شناور که نشان دهنده رتبه بندی اموال کل است. | این عدد معمولاً از 0-5، 0-10 یا 0-100 است، اما شما می توانید از هر محدوده ای که نشان دهنده سیستم رتبه بندی شما باشد استفاده کنید. به عنوان مثال، رتبه اموال باید 3 یا 4 برای رتبه_مقیاس 5 باشد. توجه: در صورتی که مشخص نشده باشد، امتیاز_مقیاس پیشفرض 0-10 است. |
مقادیر برای متغیر ویژگی_name برای Vacation Rentals
به ویژگی های خاص اجاره تعطیلات و مثال XML مراجعه کنید.
<image>
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
+ <image>
از تصاویر برای نشان دادن اموال در شناسه فهرست استفاده می شود. تمام تصاویر استفاده شده باید از این دستورالعمل پیروی کنند:
- نسبت تصویر توصیه شده برای تصاویر 4:3 است.
- URL تصویر باید توسط خزنده تصویر Googlebot قابل دسترسی باشد.
اگر سایت شما دارای robots.txt در سطح ریشه است، بررسی کنید که حاوی یکی از دو گزینه زیر باشد:
به خزنده Googlebot اجازه میدهد تا محتوای سایت شما، شامل تصاویر را بخزد.
- عامل کاربر: Googlebot
- اجازه می دهد: /
به خزنده تصویر Googlebot اجازه می دهد تا تصاویر موجود در سایت شما را بخزد.
- عامل کاربر: Googlebot-Image
- اجازه می دهد: /
گرفتن اسکرین شات از تصاویر یا وب سایت ها مجاز نیست. تصاویر باید تصاویر یا عکس های اصلی و واقعی باشند.
صفات
نام صفت | مورد نیاز؟ | قالب | توضیحات |
---|---|---|---|
type | Required | Text | یک تصویر باید یکی از موارد زیر باشد: |
url | Required | Text | URL تصویر در اندازه کامل. از ویژگی url برای تعیین تصویر مورد استفاده در آن صفحه استفاده کنید. |
width | Required | A non-negative integer | عرض تصویر، بر حسب پیکسل (بیشتر از 720 پیکسل توصیه می شود) |
height | Required | A non-negative integer | ارتفاع تصویر، بر حسب پیکسل (بیشتر از 720 پیکسل توصیه می شود) |
عناصر کودک
عنصر کودک | مورد نیاز؟ | توضیحات |
---|---|---|
<link> | درخواست شده، اما برای لیست عکس های محلی لازم است . | این تگ حاوی URL معتبر و به روز صفحه ای در سایت شما است که تصویر مربوطه در آن قرار دارد. این نشانی وب خود تصویر را ندارد. مثال:<link><http://www.example.com/magic_pizza/></link> |
<title> | درخواست شده است | این تگ شامل عنوان تصویر است. مثال: <title>"Luxury Apartment"</title> |
<author> | لازم نیست | نام نویسنده مطلب. مقدار می تواند یک نام کاربری یا یک نام کامل در قالب "نام خانوادگی" باشد. |
<date> | مورد نیاز | این تگ تاریخ ایجاد آیتم محتوا را مشخص می کند. شما باید یک سال، ماه و روز را مانند مثال زیر وارد کنید: <date month="6" day="7" year="2023"/> |
مثال
مثال زیر یک لیست جزئی هتل با برچسب های تصویر را نشان می دهد:
<?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>
<content>
<review>
</review>
<attributes>
</attributes>
<image type="photo" url="https://image_url" width="400" height="300">
<link>https://image_url</link>
<title>Apartment at Sandstone</title>
<author>Jessica Landlord</author>
<date month="6" day="7" year="2023"/>
</image>
</content>
</listing>
...
</listings>
دستورالعمل های نحوی
هنگام ایجاد یک لیست هتل مبتنی بر XML، از دستورالعمل های زیر استفاده کنید:
فایل های XML فهرست هتل خود را با طرحواره XSD Google اعتبار سنجی کنید.
از رمزگذاری UTF-8 استفاده کنید. همانطور که در مثال های زیر نشان داده شده است، این طرح رمزگذاری را با گنجاندن ویژگی
encoding
در تگ XML خود مشخص کنید.می توانید مقادیر داده را در فید خود با بخش های
CDATA
مشخص کنید. اگر از بخشهایCDATA
استفاده میکنید، از کاراکترهای خاص فرار نکنید.از کدهای فرار برای مقادیر داده ای که در بخش های
CDATA
نیستند، از جمله URL ها استفاده کنید. شما می توانید از کد موجودیت یا کد کاراکتر برای نمایش این کاراکترهای خاص استفاده کنید. جدول زیر کدهای موجودیت و کاراکتر رایجی را که می توانید استفاده کنید فهرست می کند:شخصیت موجودیت کد کاراکتر آمپرسند (&) & & نقل قول واحد (') ' ' نقل قول دوگانه (") " " بزرگتر از (>) > > کمتر از (<) &آن؛ < عناصر XML که حاوی داده نیستند را حذف کنید. به عنوان مثال، اگر طول و عرض جغرافیایی برای یک هتل ندارید، نباید عناصر خالی
<latitude/>
و<longitude/>
را وارد کنید.تحت هیچ شرایطی از HTML در عناصر XML خود استفاده نکنید (حتی اگر فرار شده باشد).
برای اعتبارسنجی فید خود قبل از آپلود، میتوانید از فید محلی XSD http://www.gstatic.com/localfeed/local_feed.xsd استفاده کنید.
برای استفاده از نظرات در فید خود، نظر را در تگ های
<!--
و-->
بپیچید، همانطور که مثال زیر نشان می دهد:<!-- This is a comment -->
مطمئن شوید که عنصر
<date>
را در کاربر<review>
بسته اید. به عنوان مثال:<date day="2" month="12" year="2017"/>
فهرست هتل یک یا چند فایل XML است که تمام هتلهایی را که اطلاعات قیمت آنها را ارائه میکنید فهرست میکند. فایل لیست هتل خود حاوی اطلاعات قیمت نیست.
عنصر اصلی لیست هتل، عنصر <listings>
است که حاوی عناصر <listing>
است که خواص شما را توصیف می کند.
شما یک لیست هتل را به عنوان بخشی از پیاده سازی اولیه خود ایجاد می کنید و سپس هتل ها را به عنوان بخشی از تعمیر و نگهداری منظم از آن اضافه یا حذف می کنید.
مطمئن شوید که فایل های شما مطابق دستورالعمل های نحوی هستند. به عنوان مثال، از رمزگذاری UTF-8 استفاده کنید و این طرح رمزگذاری را با گنجاندن ویژگی encoding
در تگ XML خود مشخص کنید.
پس از ایجاد لیست هتل، میتوانید آن را بهصورت دستی با استفاده از Hotel Center در Google آپلود کنید یا آن را روی سرور خود میزبانی کنید .
مشکلات داده را پیدا و برطرف کنید
برای یافتن و رفع مشکلات داده در لیست هتل خود، به مقالات زیر مراجعه کنید:
الزامات فهرست
برای واجد شرایط بودن برای تبلیغات هتل گوگل، یک ملک در لیست هتل شما باید دارای موارد زیر باشد:
- اتاق هایی که میهمانان پولی می توانند در آنها اقامت کنند
- حضور فیزیکی و مکان ثابتی که برای عموم آزاد است
- دیوارهای ثابت و لوله کشی
- حداقل نیاز به اقامت بیش از 7 روز نیست
نمونههای متداول املاک غیرقابل صلاحیت شامل سفرهای دریایی و آپارتمانها است زیرا معمولاً معیارهای Listing requirements
برآورده نمیکنند.
کابینهای کمپینگ و سایر مکانهای کمپینگ با دیوارهای ثابت، لولهکشی و کنترل آب و هوا (از جمله اجاقهای چوبی یا بخاریهای پروپان) واجد شرایط هستند. اقامتگاه های فضای باز که واجد شرایط نیستند عبارتند از:
- کمپینگ، جایی که مهمانان در چادر اقامت می کنند
- پارکهای RV، جایی که مهمانان RV خود را میآورند
<listings>
<listings>
عنصر اصلی یک لیست هتل است و حاوی یک عنصر <language>
و حداقل یک <listing>
است.
عنصر <listings>
در مکان زیر در سلسله مراتب XML لیست هتل ظاهر می شود:
+ <listings>
+ <language>
+ <datum>
+ <listing>
نحو
عنصر <listings>
از نحو زیر استفاده می کند:
<?xml version="1.0" encoding="UTF-8"?>
<listings xmlns:xsi="xsi"
xsi:noNamespaceSchemaLocation="schema_xsd">
<language> language_code</language>
<datum> datum_code </datum>
<listing> listing</listing>
...
</listings>
صفات
عنصر <listings>
دارای ویژگی های زیر است:
صفت | مورد نیاز؟ | توضیحات |
---|---|---|
xmlns:xsi | مورد نیاز | روی http://www.w3.org/2001/XMLSchema-instance تنظیم کنید. |
xsi:noNamespaceSchemaLocation | مورد نیاز | روی http://www.gstatic.com/localfeed/local_feed.xsd تنظیم کنید. |
عناصر کودک
عنصر <listings>
دارای عناصر فرزند زیر است:
عنصر کودک | مورد نیاز؟ | تایپ کنید | توضیحات |
---|---|---|---|
<language> | Required | string | زبانی که فید شما به آن نوشته شده است. مقدار این عنصر را روی یک کد زبان دو حرفی تنظیم کنید. به عنوان مثال، en برای انگلیسی. |
<datum> | Optional | enum | این عنصر مبدأ ژئودزیکی یا مدل مرجع مختصات طول و عرض جغرافیایی ارائه شده در خوراک را مشخص می کند. اگر مقدار مبنا ارائه نشود، مقدار پیشفرض این عنصر WGS84 است که توسط اکثر دستگاههای GPS مدرن استفاده میشود. داده توکیو فقط برای آدرس های ژاپن قابل اجرا است.مقادیر معتبر برای این عنصر عبارتند از:
WGS84 ، عنصر <datum> را در لیست هتل وارد نکنید. |
<listing> | Required | <listing> | یک یا چند ورودی که هر هتل را در فید توصیف می کند. توجه داشته باشید که هر هتل در لیست باید دارای یک شناسه منحصر به فرد برای سایت شما باشد و این شناسه هرگز نباید دوباره استفاده شود. |
نمونه ها
آدرس ساختاریافته
مثال زیر یک لیست جزئی هتل را با یک آدرس ساختاریافته نشان می دهد:
<?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>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<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>
<country>GB</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
آدرس فرم آزاد
مثال زیر یک لیست جزئی هتل را با یک آدرس رایگان نشان می دهد:
<?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>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<address>6 Elm Ave Unit 3, Boston, MA, 02472</address>
<country>US</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
محتوای اختیاری
مثال زیر یک لیست جزئی هتل را با فهرستی نشان می دهد که حاوی یک <content>
اختیاری است:
<?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>
<listing>
تعریف هتل در عنصر <listings>
فهرست هتل.
عنصر <listing>
در مکان زیر در سلسله مراتب XML Feed List Hotel ظاهر می شود:
+ <listings>
+ <language>
+ <listing>
نحو
عنصر <listing>
از نحو زیر استفاده می کند:
<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
<listing>
<!-- Specify <listing>'s child elements in the order shown below. -->
<id>hotel_ID</id>
<name>hotel_name</name>
<address>
<component name="addr1">street_address_1</component>
<component name="addr2">street_address_2</component>
<component name="city">city_name</component>
<component name="province">province_name</component>
<component name="postal_code">postal_code</component>
</address>
<!-- You can also define an address freeform, although this is not recommended: -->
<!-- <address>freeform_address</address> -->
<country>country_code</country>
<latitude>hotel_latitude</latitude>
<longitude>hotel_longitude</longitude>
<phone type="[fax|main|mobile|tdd|tollfree]">phone_number</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
<content>content</content>
</listing>
</listings>
صفات
عنصر <listing>
هیچ ویژگی ندارد.
عناصر کودک
عنصر <listing>
دارای عناصر فرزند زیر است:
عنصر کودک | مورد نیاز؟ | تایپ کنید | توضیحات |
---|---|---|---|
<id> | Required | string | یک شناسه منحصر به فرد برای هتل. توجه: این مقدار باید برای همیشه برای سایت شما منحصر به فرد باشد. از شناسهها استفاده مجدد نکنید ، زیرا ممکن است هنگام تلاش برای حل مشکلات تطبیق دارایی، مشکل ایجاد کند. |
<name> | Required | string | نام هتل. به عنوان مثال: <name>Belgrave House</name> |
<address> | Required | Object or string | موقعیت فیزیکی کامل هتل. این عنصر یک ویژگی واحد به حداقل باید آدرس خیابان، شهر، ایالت یا منطقه و کد پستی هتل را ارائه دهید. از عناصر فرزند
به عنوان مثال: <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> توجه داشته باشید که صندوقهای پستی یا سایر آدرسهای فقط پستی، آدرسهای فیزیکی کامل در نظر گرفته نمیشوند. |
<country> | Required | string | کشوری که این فهرست در آن قرار دارد. مقدار باید یک کد کشور دو حرفی باشد. برای مثال، ایالات متحده "US" و کانادا "CA" است. به عنوان مثال: <country>US</country> |
<latitude> | Required* | float | عرض جغرافیایی که با مکان فهرست مطابقت دارد. به عنوان مثال: <latitude>37.423738</latitude> این مقدار را می توان با ابزارهای GeoCoding مانند Google Maps API ایجاد کرد. |
<longitude> | Required* | float | طول جغرافیایی که با مکان فهرست مطابقت دارد. به عنوان مثال: <longitude>-122.090101</longitude> این مقدار را می توان با ابزارهای GeoCoding مانند Google Maps API ایجاد کرد. |
<location_precision> | Optional | integer | زمانی که طول و عرض جغرافیایی ملک مبهم باشد، دقت موقعیت ملک بر حسب متر ارسال می شود. صفر (0) به این معنی است که هیچ ابهامی وجود ندارد و مکان دقیق آن است. توجه: این عنصر فقط برای اجاره تعطیلات اعمال می شود. |
<phone> | Required* | string | یک یا چند شماره تماس برای هتل. اگر فهرست شعبه تجاری است، لطفاً شماره تلفن مخصوص محل شعبه (نه شماره تلفن دفتر مرکزی) را ارائه دهید. ویژگی
به عنوان مثال: <!-- Singapore (country code +65) --> <phone type="main">+65 6722-2323</phone> <!-- U.S. (country code +1) --> <phone type="fax">+1 408-555-1111</phone> حداقل باید یک نوع |
<category> | Optional | string | نوع ملک مانند هتل. شرکا ممکن است از هر دسته بندی داخلی که دارند برای توصیف دارایی خود استفاده کنند، مانند "هتل های تجاری"، "مرکز استراحتگاه ها"، "متل ها" و موارد مشابه. |
<content> | Optional | <content> | جزئیات اختیاری مورد استفاده برای فهرست، مانند توضیحات، رتبهبندی و ویژگیهای ملک. |
* شماره تلفن یا طول و عرض جغرافیایی لازم است. توصیه می کنیم هر دو را تعریف کنید.
نمونه ها
آدرس ساختاریافته
مثال زیر یک لیست جزئی هتل را با یک آدرس ساختاریافته نشان می دهد:
<?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>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<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>
<country>GB</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
آدرس فرم آزاد
مثال زیر یک لیست جزئی هتل را با یک آدرس رایگان نشان می دهد:
<?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>
<!-- The value of <id> must be unique to your site for all time. Do NOT reuse IDs. -->
<id>123abc</id>
<name>Belgrave House</name>
<address>6 Elm Ave Unit 3, Boston, MA, 02472</address>
<country>US</country>
<latitude>35.070374</latitude>
<longitude>-106.213648</longitude>
<phone type="main">123-456-7890</phone>
<category>hotel</category> <!-- You can use whatever property type categories you wish -->
</listing>
...
</listings>
محتوای اختیاری
مثال زیر یک لیست جزئی هتل را با فهرستی نشان می دهد که حاوی یک <content>
اختیاری است:
<?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>
<content>
اطلاعاتی در مورد یک فهرست، مانند رتبهبندیها و نظرات، امکانات رفاهی و جزئیات دیگر اضافه میکند. عنصر <content>
اختیاری است. در <content>
، همه عناصر فرزند اختیاری هستند.
عنصر <content>
در مکان زیر در سلسله مراتب XML Feed List Hotel ظاهر می شود:
+ <listings>
+ <language>
+ <listing>
+ <content>
نحو
عنصر <content>
از نحو زیر استفاده می کند:
<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
<listing>
<content>
<!-- Specify <text>'s child elements in the order shown below. -->
<text type="description">
<link>listing_link</link>
<title>listing_title</title>
<author>listing_author</author>
<body>listing_description</body>
<date month="MM" day="DD" year="YYYY"/>
</text>
<!-- 0 or more reviews: -->
<review type="[editorial|user]">
...
</review>
<!-- 0 or more attributes: -->
<attributes>
<website>https://hotel.example.com</website>
<client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
<client_attr name="custom_0">custom_attribute_0</client_attr>
<client_attr name="custom_1">custom_attribute_1</client_attr>
<client_attr name="custom_2">custom_attribute_2</client_attr>
<client_attr name="custom_3">custom_attribute_3</client_attr>
<client_attr name="custom_4">custom_attribute_4</client_attr>
<client_attr name="hotel_brand">hotel_brand</client_attr>
<client_attr name="num_reviews">number_of_reviews</client_attr>
<client_attr name="rating">aggregate_rating</client_attr>
</attributes>
<!-- a picture of the hotel or property-->
<image type="photo" url="https://image_url">
<link>https://image_url</link>
<title>Main Hotel Picture</title>
</image>
</content>
</listing>
...
</listings>
صفات
عنصر <content>
هیچ ویژگی ندارد.
عناصر کودک
عنصر <content>
دارای عناصر فرزند زیر است:
عنصر کودک | مورد نیاز؟ | تایپ کنید | توضیحات |
---|---|---|---|
<text type= "description"> | Optional | Object | صفحه وب مرتبط با فهرست ارائه دهنده. دارای عناصر کودک زیر است:
توجه : این عناصر باید به ترتیب بالا ظاهر شوند. |
<review type= "[editorial| user]"> | Optional | <review> | شامل یک بررسی کاربر یا یک بررسی سرمقاله از فهرست است. فهرست شما میتواند دارای هر تعداد نظر از هر نوع باشد. لازم نیست همه بررسیهای یک ویژگی را در عنصر |
<attributes> | Optional | Object | حاوی 0 یا بیشتر <client_attr name="attribute_name">attribute_value<client_attr> برای فهرست و توضیح عناصر فرزند، به همه عناصر اگر عنصر فرزند |
<image> | Optional | Object | برچسب تکرار شده، حاوی اطلاعات دقیق تصویر است. |
مثال
مثال زیر یک لیست هتل جزئی را نشان می دهد که شامل عنصر <content>
است:
<?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>
<review>
شامل یک بررسی کاربر یا یک بررسی سرمقاله است. نیازی نیست تمام نظرات یک فهرست را در عنصر <listing>
خود قرار دهید. این عنصر برای شما در نظر گرفته شده است که نظرات منتخبی را که نشانگر ویژگیها یا کیفیت این فهرست هستند را شامل شود.
عنصر <review>
در مکان زیر در سلسله مراتب XML Feed List Hotel ظاهر می شود:
+ <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 | یک عدد ممیز شناور از 0 تا 10 (شامل) که نشان دهنده امتیاز بررسی است. به عنوان مثال، "8.9". |
<body> | Optional | string | متن بررسی. این عنصر نباید حاوی HTML باشد. |
<date month=" MM " day=" DD " year=" YYYY "/> | Optional | Object | (فقط نظرات کاربران) تاریخ بررسی که با ویژگی های زیر این عنصر را مشخص می کنید:
به عنوان مثال، 7 ژوئن 2023 به صورت زیر نوشته شده است: <date month="6" day="7" year="2023"/> |
<servicedate month=" MM " day=" DD " year=" YYYY "/> | Optional | Object | (فقط نظرات کاربران) تاریخی که بازبین از فهرست در حال بررسی بازدید کرده است. قالب همان <date> بالا است. به عنوان مثال، 7 ژوئن 2023 به صورت زیر نوشته شده است: <servicedate month="6" day="7" year="2023"/> نظرات بدون حداقل ماه و سال <servicedate> ممکن است نشان داده نشوند. روز لازم نیست. |
توجه داشته باشید که <title>
تنها در صورتی یک عنصر فرزند معتبر <review>
است که type
بررسی editorial
باشد و <date>
فقط در صورتی معتبر است که type
user
باشد.
مثال
مثال زیر یک لیست هتل جزئی را با فهرستی که حاوی سرمقاله و نظر کاربر است نشان می دهد:
<?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>
<attributes>
تگ <attributes>
می تواند برای توصیف امکانات رفاهی و طبقه بندی رتبه بندی ها و بررسی های ملک استفاده شود.
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
عناصر کودک
عنصر کودک | مورد نیاز؟ | توضیحات | |
---|---|---|---|
<website> | Optional | وب سایت اصلی هتل در صورت وجود، باید قبل از اولین عنصر <client_attr> قرار گیرد. مثال: <website>https://hotel.example.com</website> | |
<client_attr name=" attribute_name "> | Optional | یک مشخصه یا "ویژگی" اضافی از ویژگی که می تواند با استفاده از attribute_name یا attribute_name پشتیبانی شده برای اجاره تعطیلات مشخص شود. |
مقادیر برای مکان نگهدار ویژگی_name
جدول زیر مقادیر معتبر attribute_name را در عنصر <client_attr name=" attribute_name "> فهرست میکند.
مقادیر attribute_name | توضیحات | مقادیر محتوای معتبر |
---|---|---|
alternate_hotel_id | یک شناسه جایگزین برای ملک شما داشتن شناسههای جداگانه مفید است اگر ممکن است به یک شناسه دارایی برای اطلاعات فید خود و یک شناسه ملک دیگر برای موتور رزرو خود نیاز داشته باشید. | هر مقدار رشته |
custom_[0-4] | هر نوع رشته ای از ویژگی های سفارشی. این ها به کاربران نمایش داده نمی شوند. | هر مقدار رشته |
hotel_brand | برندی که این هتل به آن تعلق دارد. مثلاً «ماریوت» یا «هیلتون». این برای کاربران نمایش داده نمی شود، اما می توان از آن برای گروه بندی هتل ها استفاده کرد. | هر مقدار رشته |
lodging | نمایش کدگذاری شده از تمام فیلدهای موجود در پروتوی Lodging . | رشته کدگذاری شده با Base64 از پروتکل Lodging کدگذاری شده |
num_reviews | تعداد بررسی های لیست | هر عدد صحیح غیر منفی |
rating | یک عدد ممیز شناور که نشان دهنده رتبه بندی اموال کل است. | این عدد معمولاً از 0-5، 0-10 یا 0-100 است، اما شما می توانید از هر محدوده ای که نشان دهنده سیستم رتبه بندی شما باشد استفاده کنید. به عنوان مثال، رتبه اموال باید 3 یا 4 برای رتبه_مقیاس 5 باشد. توجه: در صورتی که مشخص نشده باشد، امتیاز_مقیاس پیشفرض 0-10 است. |
مقادیر برای متغیر ویژگی_name برای Vacation Rentals
به ویژگی های خاص اجاره تعطیلات و مثال XML مراجعه کنید.
<image>
+ <listings>
+ <language>
+ <listing>
+ <content>
+ <review>
+ <attributes>
+ <image>
از تصاویر برای نشان دادن اموال در شناسه فهرست استفاده می شود. تمام تصاویر استفاده شده باید از این دستورالعمل پیروی کنند:
- نسبت تصویر توصیه شده برای تصاویر 4:3 است.
- URL تصویر باید توسط خزنده تصویر Googlebot قابل دسترسی باشد.
اگر سایت شما دارای robots.txt در سطح ریشه است، بررسی کنید که حاوی یکی از دو گزینه زیر باشد:
به خزنده Googlebot اجازه میدهد تا محتوای سایت شما، شامل تصاویر را بخزد.
- عامل کاربر: Googlebot
- اجازه می دهد: /
به خزنده تصویر Googlebot اجازه می دهد تا تصاویر موجود در سایت شما را بخزد.
- عامل کاربر: Googlebot-Image
- اجازه می دهد: /
گرفتن اسکرین شات از تصاویر یا وب سایت ها مجاز نیست. تصاویر باید تصاویر یا عکس های اصلی و واقعی باشند.
صفات
نام صفت | مورد نیاز؟ | قالب | توضیحات |
---|---|---|---|
type | Required | Text | یک تصویر باید یکی از موارد زیر باشد: |
url | Required | Text | URL تصویر در اندازه کامل. از ویژگی url برای تعیین تصویر مورد استفاده در آن صفحه استفاده کنید. |
width | Required | A non-negative integer | عرض تصویر، بر حسب پیکسل (بیشتر از 720 پیکسل توصیه می شود) |
height | Required | A non-negative integer | ارتفاع تصویر، بر حسب پیکسل (بیشتر از 720 پیکسل توصیه می شود) |
عناصر کودک
عنصر کودک | مورد نیاز؟ | توضیحات |
---|---|---|
<link> | درخواست شده، اما برای لیست عکس های محلی لازم است . | این تگ حاوی URL معتبر و به روز صفحه ای در سایت شما است که تصویر مربوطه در آن قرار دارد. این نشانی وب خود تصویر را ندارد. مثال:<link><http://www.example.com/magic_pizza/></link> |
<title> | درخواست شده است | این تگ شامل عنوان تصویر است. مثال: <title>"Luxury Apartment"</title> |
<author> | لازم نیست | نام نویسنده مطلب. مقدار می تواند یک نام کاربری یا یک نام کامل در قالب "نام خانوادگی" باشد. |
<date> | مورد نیاز | این تگ تاریخ ایجاد آیتم محتوا را مشخص می کند. شما باید یک سال، ماه و روز را مانند مثال زیر وارد کنید: <date month="6" day="7" year="2023"/> |
مثال
مثال زیر یک لیست جزئی هتل با برچسب های تصویر را نشان می دهد:
<?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>
<content>
<review>
</review>
<attributes>
</attributes>
<image type="photo" url="https://image_url" width="400" height="300">
<link>https://image_url</link>
<title>Apartment at Sandstone</title>
<author>Jessica Landlord</author>
<date month="6" day="7" year="2023"/>
</image>
</content>
</listing>
...
</listings>
دستورالعمل های نحوی
هنگام ایجاد یک لیست هتل مبتنی بر XML، از دستورالعمل های زیر استفاده کنید:
فایل های XML فهرست هتل خود را با طرحواره XSD Google اعتبار سنجی کنید.
از رمزگذاری UTF-8 استفاده کنید. همانطور که در مثال های زیر نشان داده شده است، این طرح رمزگذاری را با گنجاندن ویژگی
encoding
در تگ XML خود مشخص کنید.می توانید مقادیر داده را در فید خود با بخش های
CDATA
مشخص کنید. اگر از بخشهایCDATA
استفاده میکنید، از کاراکترهای خاص فرار نکنید.از کدهای فرار برای مقادیر داده ای که در بخش های
CDATA
نیستند، از جمله URL ها استفاده کنید. شما می توانید از کد موجودیت یا کد کاراکتر برای نمایش این کاراکترهای خاص استفاده کنید. جدول زیر کدهای موجودیت و کاراکتر رایجی را که می توانید استفاده کنید فهرست می کند:شخصیت موجودیت کد کاراکتر آمپرسند (&) & & نقل قول واحد (') ' ' نقل قول دوگانه (") " " بزرگتر از (>) > > کمتر از (<) &آن؛ < عناصر XML که حاوی داده نیستند را حذف کنید. به عنوان مثال، اگر طول و عرض جغرافیایی برای یک هتل ندارید، نباید عناصر خالی
<latitude/>
و<longitude/>
را وارد کنید.تحت هیچ شرایطی از HTML در عناصر XML خود استفاده نکنید (حتی اگر فرار شده باشد).
برای اعتبارسنجی فید خود قبل از آپلود، میتوانید از فید محلی XSD http://www.gstatic.com/localfeed/local_feed.xsd استفاده کنید.
برای استفاده از نظرات در فید خود، نظر را در تگ های
<!--
و-->
بپیچید، همانطور که مثال زیر نشان می دهد:<!-- This is a comment -->
مطمئن شوید که عنصر
<date>
را در کاربر<review>
بسته اید. به عنوان مثال:<date day="2" month="12" year="2017"/>