فهرست هتل مرجع XML

فهرست هتل یک یا چند فایل 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
  • wgs84
  • TOKYO
  • tokyo
توجه: برای استفاده از مقدار پیش‌فرض 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, 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

موقعیت فیزیکی کامل هتل.

این عنصر یک ویژگی واحد format می گیرد که باید آن را روی simple تنظیم کنید.

حداقل باید آدرس خیابان، شهر، ایالت یا منطقه و کد پستی هتل را ارائه دهید. از عناصر فرزند <component> برای توصیف هر یک از بخش های زیر از آدرس استفاده کنید:

  • addr1 : آدرس خیابان اصلی هتل.
  • addr2 : آدرس خیابان ثانویه، در صورت لزوم.
  • addr3 : در صورت لزوم، قسمت سوم آدرس خیابان.
  • city ​​: نام شهر هتل.
  • province : نام ایالت، منطقه یا استان هتل.
  • postal_code : کد پستی هتل.

مثلا:

<address format="simple">
  <component name="addr1">6 Acacia Ave</component>
  <component name="addr2">Floor 5</component>
  <component name="city">London</component>
  <component name="province">Greater London</component>
  <component name="postal_code">SW1W 9TQ</component>
</address>

از طرف دیگر، می‌توانید یک آدرس «رایگان» ارائه کنید، اگرچه این توصیه نمی‌شود. مثلا:

<address>6 Elm Ave, 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

یک یا چند شماره تماس برای هتل. اگر فهرست شعبه تجاری است، لطفاً شماره تلفن مخصوص محل شعبه (نه شماره تلفن دفتر مرکزی) را ارائه دهید.

ویژگی type می تواند یکی از موارد زیر باشد:

  • fax : شماره تلفن فکس.
  • main : شماره تلفن صوتی اصلی.
  • mobile : شماره تلفن همراه.
  • tdd : شماره تلفن دستگاه مخابراتی ناشنوایان (TDD).
  • tollfree : شماره تلفن رایگان.

مثلا:

<!-- Singapore (country code +65) -->
<phone type="main">+65 6722-2323</phone>
<!-- U.S. (country code +1) -->
<phone type="fax">+1 408-555-1111</phone>

حداقل باید یک نوع main ارائه دهید.

<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, 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

صفحه وب مرتبط با فهرست ارائه دهنده. دارای عناصر کودک زیر است:

  • <link> : پیوندی به توضیحات. شامل "http://" یا
    "https://" در این عنصر (اختیاری).
  • <title> : عنوان توضیحات (اختیاری).
  • <author> : نویسنده توضیحات (اختیاری).
  • <body> : بدنه توضیحات ( لازم است ).
  • <date> : تاریخ توضیحات (اختیاری).

    • توجه : این عناصر باید به ترتیب بالا ظاهر شوند.

<review type= "[editorial| user]"> Optional <review>

شامل یک بررسی کاربر یا یک بررسی سرمقاله از فهرست است. فهرست شما می‌تواند دارای هر تعداد نظر از هر نوع باشد.

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

<attributes> Optional Object

حاوی 0 یا بیشتر <client_attr> عنصر فرزند است که جزئیاتی را در مورد دارایی ارائه می دهد. عناصر فرزند از نحو زیر استفاده می کنند:

<client_attr name="attribute_name">attribute_value<client_attr>

برای فهرست و توضیح عناصر فرزند، به <attributes> مراجعه کنید.

همه عناصر <client_attr> اختیاری هستند.

اگر عنصر فرزند <website> وجود داشته باشد، باید قبل از هر عنصر <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 نوع بررسی. یکی از مقادیر زیر را تنظیم کنید:
  • editorial : بررسی توسط یک وب سایت یا سایر مراجع بازبینی کننده.
  • user : بررسی توسط کاربر نهایی.

عناصر کودک

عنصر <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 (فقط نظرات کاربران) تاریخ بررسی که با ویژگی های زیر این عنصر را مشخص می کنید:
  • day : روز ماه; به عنوان مثال، "7".
  • month : ماهی که 1 = ژانویه ... 12 = دسامبر.
  • year : سال چهار رقمی; به عنوان مثال "2023".

به عنوان مثال، 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 است، اما شما می توانید از هر محدوده ای که نشان دهنده سیستم رتبه بندی شما باشد استفاده کنید.

مقادیر برای متغیر ویژگی_name برای Vacation Rentals

به ویژگی های خاص اجاره تعطیلات و مثال XML مراجعه کنید.

<image>

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

از تصاویر برای نشان دادن اموال در شناسه فهرست استفاده می شود. تمام تصاویر استفاده شده باید از این دستورالعمل پیروی کنند:

  • نسبت تصویر توصیه شده برای تصاویر 4:3 است.
  • URL تصویر باید توسط خزنده تصویر Googlebot قابل دسترسی باشد.

  • اگر سایت شما دارای robots.txt در سطح ریشه است، بررسی کنید که حاوی یکی از دو گزینه زیر باشد:

    1. به خزنده Googlebot اجازه می‌دهد تا محتوای سایت شما، شامل تصاویر را بخزد.

      • عامل کاربر: Googlebot
      • اجازه: /

    2. به خزنده تصویر Googlebot اجازه می دهد تا تصاویر موجود در سایت شما را بخزد.

      • عامل کاربر: Googlebot-Image
      • اجازه: /

  • گرفتن اسکرین شات از تصاویر یا وب سایت ها مجاز نیست. تصاویر باید تصاویر یا عکس های اصلی و واقعی باشند.

ویژگی های

  • "ad" اگر تصویر یک تبلیغ باشد
  • "menu" اگر تصویر منوی رستوران باشد
  • "photo" اگر تصویر یک عکس از کسب و کار باشد
نام مشخصه ضروری؟ قالب شرح
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 ها استفاده کنید. شما می توانید از کد موجودیت یا کد کاراکتر برای نمایش این کاراکترهای خاص استفاده کنید. جدول زیر کدهای موجودیت و کاراکتر رایجی را که می توانید استفاده کنید فهرست می کند:

    شخصیت وجود، موجودیت کد کاراکتر
    آمپرسند (&) &amp; &#38;
    نقل قول تکی (') &apos; &#39;
    نقل قول دوگانه (") &quot; &#34;
    بزرگتر از (>) &gt; &#62;
    کمتر از (<) &آن؛ &#60;

  • عناصر 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"/>