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

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

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

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

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

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

پیدا کردن و رفع مشکلات داده‌ها

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

الزامات فهرستگان

برای واجدشرایط بودن برای «آگهی‌های هتل از Google»، دارایی موجود در فهرست هتل شما باید دارای موارد زیر باشد:

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

نمونه‌های رایج از دارایی‌های غیرواجدشرایط شامل سفرهای دریایی و آپارتمان‌ها است زیرا معمولاً معیارهای Listing requirements را برآورده نمی‌کنند.

کلبه‌های کمپینگ و سایر تأسیسات کمپینگ با دیوارهای ثابت، لوله‌کشی، و کنترل دما (ازجمله اجاق‌های هیزمی یا بخاری‌های پروپان) واجدشرایط هستند. اقامتگاه‌های فضای باز که واجدشرایط نیستند عبارت‌اند از:

  • محوطه‌های کمپینگ که مهمانان در چادر اقامت می‌کنند
  • پارک خودروهای تفریحی، که مهمانان خودرو تفریحی خودشان را می‌آورند

<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 فید «فهرست هتل» نشان داده می‌شود:

+ <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 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 دقت مکان ملک ارسال‌شده برحسب متر وقتی طول و عرض جغرافیایی ملک مبهم است. صفر (۰) یعنی هیچ ابهامی وجود ندارد و مکان دقیق است. توجه: این عنصر فقط برای «اقامتگاه‌های اجاره‌ای» اعمال می‌شود.
<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 فید «فهرست هتل» نشان داده می‌شود:

+ <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> هیچ مشخصه‌ای ندارد.

عناصر فرزند

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

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

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

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

    • توجه: این عناصر باید به‌ترتیب بالا نشان داده شوند.
<review type="[editorial|user]"> Optional <review>

حاوی مرور کاربر یا مرور سردبیر از فهرستگان است. فهرستگان شما می‌تواند هر تعداد مرور از هر نوعی داشته باشد.

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

نکته کلیدی: <review> فقط باید برای حساب‌های «اقامتگاه‌های اجاره‌ای» ارسال شود. برای اطلاعات بیشتر، با «مدیر فنی حساب» (TAM) تماس بگیرید.
<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>
      <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 برای «اقامتگاه‌های اجاره‌ای» پشتیبانی‌شده مشخص شود.

مقادیر جای‌بان attribute_name

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

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

نکته کلیدی: «num_reviews» فقط باید برای فیدهای «اقامتگاه‌های اجاره‌ای» ارسال شود.

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

توجه: rating_scale پیش‌فرض درصورت نامشخص بودن ۰-۱۰ است.

مقادیر جای‌بان attribute_name برای «اقامتگاه‌های اجاره‌ای»

به مشخصه‌های ویژه «اقامتگاه‌های اجاره‌ای» و نمونه XML مراجعه کنید.

<image>

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

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

  • نسبت ابعادی توصیه‌شده برای تصاویر ۴:۳ است.
  • نشانی وب تصویر باید برای خزنده Googlebot Image دردسترس باشد.

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

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

      • User-agent: Googlebot
      • مجاز: /

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

      • User-agent: Googlebot-Image
      • مجاز: /

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

  • عکس‌ها نباید حاوی بلوک‌های بزرگ نوشتار، نشان‌واره، یا ته‌نقش باشند.

مشخصه‌ها

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

تصویر باید یکی از موارد زیر باشد:
url Required Text نشانی وب تصویر با اندازه کامل. از مشخصه 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> الزامی نیست نام نویسنده محتوا. این مقدار می‌تواند نام کاربری یا نام کامل در قالب «نام نام خانوادگی» باشد.
<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 Google اعتبارسنجی کنید.

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

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

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

    نویسه نهاد کد نویسه
    امپرسند (&) &amp; &#38;
    علامت نقل‌قول تکی (') &apos; &#39;
    علامت نقل قول دوتایی (") » &#34;
    بزرگ‌تر از (>) &gt; &#62;
    کوچک‌تر از (<) &lt; &#60;

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

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

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

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

    <!-- This is a comment -->