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

فهرست هتل‌ها یک یا چند فایل XML است که تمام هتل‌هایی را که اطلاعات قیمت‌گذاری آنها را ارائه خواهید داد، فهرست می‌کند. خود فایل فهرست هتل‌ها حاوی اطلاعات قیمت‌گذاری نیست.

عنصر ریشه یک لیست هتل، عنصر <listings> است که شامل عناصر <listing> است که هتل‌های شما را توصیف می‌کنند.

شما به عنوان بخشی از پیاده‌سازی اولیه خود، یک لیست هتل ایجاد می‌کنید و سپس به عنوان بخشی از نگهداری منظم، هتل‌ها را به آن اضافه یا حذف می‌کنید.

مطمئن شوید که فایل‌های شما با دستورالعمل‌های نحوی مطابقت دارند. برای مثال، از کدگذاری UTF-8 استفاده کنید و این طرح کدگذاری را با گنجاندن ویژگی encoding در تگ XML خود مشخص کنید.

پس از ایجاد لیست هتل‌ها، می‌توانید آن را به صورت دستی با استفاده از آدرس https://support.google.com/hotelprices/ در گوگل آپلود کنید یا آن را روی سرور خود میزبانی کنید .

مشکلات داده را پیدا و برطرف کنید

برای یافتن و رفع مشکلات داده در لیست هتل خود، به مقالات زیر مراجعه کنید:

الزامات فهرست‌بندی

برای واجد شرایط بودن برای تبلیغات هتل گوگل، یک هتل در لیست هتل‌های شما باید موارد زیر را داشته باشد:

  • اتاق‌هایی که مهمانان با پرداخت هزینه می‌توانند در آنها اقامت کنند
  • حضور فیزیکی و مکان ثابتی که برای عموم آزاد است
  • دیوارهای ثابت و لوله کشی
  • حداقل مدت اقامت نباید بیشتر از ۷ روز باشد

نمونه‌های رایج از املاک غیرمجاز شامل کروزها و آپارتمان‌ها می‌شود، زیرا آنها معمولاً معیارهای 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 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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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 مربوط به Hotel List Feed در مکان زیر ظاهر می‌شود:

+ <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> هیچ ویژگی (attribute) ندارد.

عناصر فرزند

عنصر <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 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

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

ویژگی 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 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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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 مربوط به Hotel List Feed در مکان زیر ظاهر می‌شود: 

+ <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 attributes: -->
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="alternate_hotel_id">alternate_hotel_id</client_attr>
        <client_attr name="hotel_brand">hotel_brand</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> هیچ ویژگی (attribute) ندارد.

عناصر فرزند

عنصر <content> دارای عناصر فرزند زیر است:

عنصر فرزند الزامی است؟ نوع توضیحات
<text type= "description"> Optional Object

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

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

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

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

شامل یک نظر کاربر یا یک نظر ویراستاری در مورد آگهی است. آگهی شما می‌تواند هر تعداد نظر، از هر دو نوع، در خود داشته باشد.

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

نکته کلیدی: <بررسی> فقط باید برای حساب‌های اجاره تعطیلات ارسال شود. برای اطلاعات بیشتر با مدیر حساب فنی (TAM) خود تماس بگیرید.

<attributes> Optional Object

شامل ۰ یا بیشتر عنصر فرزند <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>
      <attributes>
        <website>https://hotel.example.com</website>
        <client_attr name="rating">8.2</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>
            + <attributes>

عناصر فرزند

عنصر فرزند الزامی است؟ توضیحات
<website> Optional وب‌سایت اصلی هتل. در صورت وجود، باید قبل از اولین عنصر <client_attr> قرار گیرد. مثال: 
<website>https://hotel.example.com</website>
<client_attr name=" attribute_name "> Optional یک ویژگی یا «ویژگی» اضافی از ملک که می‌تواند با استفاده از attribute_name یا attribute_name پشتیبانی شده برای Vacation Rentals مشخص شود.

مقادیر مربوط به مکان‌نمای attribute_name

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

مقادیر برای attribute_name توضیحات مقادیر محتوای معتبر
alternate_hotel_id یک شناسه جایگزین برای ملک شما. داشتن شناسه‌های جداگانه در صورتی مفید است که ممکن است به یک شناسه ملک برای اطلاعات فید خود و یک شناسه ملک دیگر برای موتور رزرو خود نیاز داشته باشید. هر مقدار رشته‌ای
منسوخ شده: هر ویژگی سفارشی از نوع رشته. این ویژگی‌ها به کاربران نمایش داده نمی‌شوند.

مهم: اگر می‌خواهید از متغیرهای CUSTOM استفاده کنید، با مدیر حساب فنی (TAM) خود تماس بگیرید.

 هر مقدار رشته‌ای
hotel_brand برندی که این هتل به آن تعلق دارد. برای مثال، «ماریوت» یا «هیلتون». این برای کاربران نمایش داده نمی‌شود اما می‌تواند برای گروه‌بندی هتل‌ها استفاده شود. از RFC 3986 (نحو عمومی URI) پیروی کنید:
  • کاراکترهای مجاز: AZ az 0-9 - _ . ~ (space)
  • کاراکترهای محدود شده: : / ? # [ ] @ ! $ & ' ( ) * + , ; = %
lodging نمایش کدگذاری شده‌ی تمام فیلدهای موجود در نمونه‌ی اولیه‌ی Lodging . رشته کدگذاری شده با Base64 از پروتوتایپ کدگذاری شده Lodging
num_reviews تعداد نظرات در مورد آگهی.

نکته کلیدی: "num_reviews" فقط باید برای فیدهای Vacation Rental ارسال شود.

 هر عدد صحیح غیر منفی.
rating یک عدد ممیز شناور که نشان‌دهنده‌ی رتبه‌بندی کلی ویژگی است. این عدد معمولاً از ۰-۵، ۰-۱۰ یا ۰-۱۰۰ است، اما می‌توانید از هر محدوده‌ای که سیستم رتبه‌بندی شما را نشان می‌دهد استفاده کنید. برای مثال، رتبه‌بندی ملک باید ۳ یا ۴ باشد برای rating_scale برابر با ۵.

نکته: اگر مقدار پیش‌فرض rating_scale مشخص نشده باشد، بین ۰ تا ۱۰ است.

مقادیر مربوط به جای‌گزین attribute_name برای Vacation Rentals

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

<image> 

+ <listings>
    + <language>
    + <listing>
        + <content>
            <!-- <review> is allowed in Vacation Rentals only -->
            + <review>
            + <attributes>
            + <image>

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

  • نسبت ابعاد توصیه شده برای تصاویر ۴:۳ است.
  • آدرس اینترنتی تصویر باید توسط خزنده تصویر گوگل بات قابل دسترسی باشد.

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

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

      • عامل کاربر: ربات گوگل
      • اجازه دهید: /

    2. به خزنده تصویر گوگل‌بات اجازه می‌دهد تا تصاویر سایت شما را بررسی کند.

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

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

ویژگی‌ها

  • اگر تصویر یک تبلیغ باشد "ad"
  • "menu" اگر تصویر مربوط به منوی رستوران باشد
  • "photo" اگر تصویر، عکسی از کسب‌وکار باشد
نام ویژگی الزامی است؟ قالب توضیحات
type Required Text

تصویر باید یکی از موارد زیر باشد:

url Required Text آدرس اینترنتی (URL) تصویر در اندازه کامل. از ویژگی url برای مشخص کردن تصویری که قرار است در آن صفحه استفاده شود، استفاده کنید.
width Required A non-negative integer عرض تصویر، بر حسب پیکسل (بیشتر از ۷۲۰ پیکسل توصیه می‌شود)
height Required A non-negative integer ارتفاع تصویر، بر حسب پیکسل (بیشتر از ۷۲۰ پیکسل توصیه می‌شود)

عناصر فرزند

عنصر فرزند الزامی است؟ توضیحات
<link> درخواست شده، اما برای فهرست عکس‌های محلی الزامی است . این تگ شامل آدرس اینترنتی معتبر و به‌روز صفحه‌ای در سایت شما است که تصویر مربوطه در آن قرار دارد. این تگ شامل آدرس اینترنتی خود تصویر نیست. مثال: 
<link><http://www.example.com/magic_pizza/></link>
<title> درخواست شده این تگ شامل عنوان تصویر است. مثال: 
<title>"Luxury Apartment"</title>
<author> لازم نیست نام نویسنده‌ی محتوا. این مقدار می‌تواند نام کاربری یا نام کامل با فرمت "Firstname Lastname" باشد.
<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>
      <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 گوگل اعتبارسنجی کنید.

  • از کدگذاری UTF-8 استفاده کنید. این الگوی کدگذاری را با وارد کردن ویژگی encoding در تگ XML خود، همانطور که در مثال‌ها نشان داده شده است، مشخص کنید.

  • شما می‌توانید مقادیر داده‌ها را در فید خود با بخش‌های CDATA مشخص کنید. اگر از بخش‌های CDATA استفاده می‌کنید، کاراکترهای خاص را escape نکنید.

  • برای مقادیر داده‌ای که در بخش‌های CDATA نیستند، از جمله URLها، از کدهای escape استفاده کنید. می‌توانید از کد موجودیت یا کد کاراکتر برای نمایش این کاراکترهای ویژه استفاده کنید. جدول زیر کدهای موجودیت و کاراکتر رایجی را که می‌توانید استفاده کنید، فهرست می‌کند:

    شخصیت نهاد کد کاراکتر
    آمپرسند (&) و &quot; (یا: &quot;)
    نقل قول تکی (') ' ... &quot; (یا: &quot;)
    دابل کوتیشن (") &quot; #34; (یا: &#34;)
    بزرگتر از (>) &gt; &#۶۲;
    کمتر از (<) &آن؛ و&#60;

  • عناصر XML که حاوی داده نیستند را حذف کنید. برای مثال، اگر طول و عرض جغرافیایی یک هتل را ندارید، نباید عناصر خالی <latitude/> و <longitude/> را وارد کنید.

  • تحت هیچ شرایطی از HTML در عناصر XML خود استفاده نکنید (حتی اگر escape شده باشد).

  • برای اعتبارسنجی فید خود قبل از آپلود، می‌توانید از XSD فید محلی http://www.gstatic.com/localfeed/local_feed.xsd استفاده کنید.

  • برای استفاده از نظرات در فید خود، همانطور که در مثال زیر نشان داده شده است، نظر را بین برچسب‌های <!-- و --> قرار دهید: 

    <!-- This is a comment -->