酒店列表 XML 参考文档

酒店列表是一个或多个 XML 文件，其中会列出您要预订的所有酒店 提供定价信息。酒店列表文件本身不包含定价 信息。

酒店列表的根元素是 <listings> 元素，其中包含 描述属性的 <listing> 元素。

作为初始实现的一部分，您需要创建酒店列表， 然后在常规维护过程中添加或移除酒店。

请确保您的文件符合语法指南。 例如，使用 UTF-8 编码，并指定此编码架构，方法是添加 XML 标记中的 encoding 属性。

创建酒店列表后，您可以使用“酒店”功能将其手动上传到 Google 中心或将其托管在 服务器。

查找并修复数据问题

如需查找和解决酒店列表中的数据问题，请参阅以下文章：

清单要求

若要投放 Google 酒店广告，酒店列表中的房源必须 具备以下特征：

  • 设有可供房客付费入住的房间
  • 有面向公众的固定的实体地点
  • 固定墙壁和管道
  • 最低入住天数不超过 7 天

不符合条件的房源的常见示例包括游轮和 公寓，因为它们通常不符合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 编写 Feed 所用的语言。设置此 元素添加到 双字母语言代码。例如，en 表示英语。
<datum> Optional enum 此元素为以下对象指定测地基准或参考模型： Feed 中提供的纬度/经度坐标。如果没有基准值 则此元素的默认值为 WGS84， 。东京数据仅适用于 日本的地址

此元素的有效值包括：

  • WGS84
  • wgs84
  • TOKYO
  • tokyo
。 注意：要使用 WGS84 的默认值，请不要添加 酒店列表中的 <datum> 元素。
<listing> Required <listing> 用于描述 Feed 中每家酒店的一个或多个条目。请注意， 列表中的每个酒店都必须有您网站专属的 ID，并且 此 ID 绝不能重复使用

示例

结构化地址

以下示例显示了包含结构化信息的部分酒店列表 地址：

<?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> 元素显示在酒店列表中的以下位置。 Feed 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 酒店的唯一标识符。

注意：您的网站在任何时候都必须是唯一的。正确做法 不要重复使用 ID，因为这可能会导致在尝试 解决房源匹配问题。
<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>

请注意，P.O.邮箱或其他仅用于邮寄的地址 视为完整的物理地址。
<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>
      <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> 元素显示在酒店列表中的以下位置。 Feed 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 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> 元素显示在酒店列表中的以下位置。 Feed XML 层次结构：

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

语法

<review> 元素使用以下语法：

<?xml version="1.0" encoding="UTF-8"?>
<listings ... >
  <listing>
    <content>
      ...
      <!-- Specify <review>'s child elements in the order shown below. -->
      <review type="editorial">
        <link>review_link</link>
        <title>review_title</title> <!-- Title is for reviews of type "editorial" only -->
        <author>review_author</author>
        <rating>review_rating</rating>
        <body>review_text</body>
        <date>review_date</date>
        <servicedate>review_servicedate</servicedate>
      </review>
      <review type="user">
        <link>review_link</link>
        <author>review_author</author>
        <date month="MM" day="DD" year="YYYY"/>  <!-- Date is for reviews of type "user" only -->
        <servicedate month="MM" day="DD" year="YYYY"/>  <!-- Service Date is for reviews of type "user" only -->
        <rating>review_rating</rating>
        <body>review_text</body>
      </review>
    </content>
  </listing>
</listings>

属性

<review> 元素具有以下属性：

特性 是否必需？ 说明
type Required 评价的类型。请设置为以下值之一： <ph type="x-smartling-placeholder">
    </ph>
  • 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 （仅限用户评论）评论日期，使用 以下属性： <ph type="x-smartling-placeholder">
    </ph>
  • day：一个月中的某天；例如 “7”。
  • month：月份，其中 1 = 1 月 ... 12 = 12 月。
  • year：四位数年份；例如“2023”。

例如，2023 年 6 月 7 日写作如下：

<date month="6" day="7" year="2023"/>
<servicedate month="MM" day="DD" year="YYYY"/> Optional Object （仅限用户评价）评价者访问所评价商家信息的日期。格式与 <date> 相同。

例如，2023 年 6 月 7 日写作如下：

<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：民宿。

attribute_name 占位符的值

下表列出了 attribute_name 的有效值 在<client_attr name="attribute_name">中元素。

attribute_name 的值 说明 有效的内容值
alternate_hotel_id 房源的备用标识符。使用单独的 ID 非常有用 您可能需要为 Feed 信息设置一个房源标识符 预订引擎的其他房源标识符。 任意字符串值
custom_[0-4] 任何字符串类型的自定义属性。这些信息不会向用户显示。 任意字符串值
hotel_brand 此酒店所属品牌，例如：“Marriott”或 “Hilton”。此名称不会向用户显示，但可用于分组 酒店。 任意字符串值
lodging 以编码表示 Lodging proto。 以 Base64 编码的字符串， 经过编码 Lodging proto
num_reviews 商家信息的评价数。 任何非负整数。
rating 表示总体房源评分的浮点数。 此数字通常为 0-5、0-10 或 0-100， 您可以使用任何能代表您的分级制度的范围

民宿的 attribute_name 占位符值

请参阅民宿专用属性和 XML 示例。

<image>

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

图片用于在房源 ID 中显示房源。使用的所有图片都必须 请遵循以下准则：

  • 建议的图片宽高比为 4:3。
  • 图片网址必须可供 Googlebot 图片抓取工具访问。

  • 如果您的网站在根级目录包含 robots.txt，请确认其包含 选择下列两个选项之一：

    1. 允许 Googlebot 抓取工具抓取您网站的内容（包括图片）。

      • User-agent: Googlebot
      • Allow: /

    2. 允许 Googlebot 图片抓取工具抓取您网站上的图片。

      • User-agent: Googlebot-Image
      • Allow: /

  • 不得提供图片或网站的屏幕截图。图片必须为原创图片 以及实际图像或照片。

。

属性

  • 如果图片是广告，则为 "ad"
  • 如果图片是餐馆菜单，则为 "menu"
  • 如果图片是商家照片，则为 "photo"
属性名称 是否必需？ 格式 说明
type Required Text

图片必须为以下项之一：
url Required Text 完整尺寸图片的网址。使用 url 属性指定 要在该页面上使用的图片
width Required A non-negative integer 图片的宽度，以像素为单位（大于 720 像素表示 ）
height Required A non-negative integer 图片的高度，以像素为单位（大于 720 像素表示 ）

子元素

子元素 是否必需？ 说明
<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>
      <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 的酒店列表时，请遵循以下准则：

  • 使用 Google 的 XSD 架构验证您的酒店列表 XML 文件。

  • 请使用 UTF-8 编码。通过添加 encoding 来指定此编码架构 属性，如下面的示例所示。

  • 您可以在 Feed 中的 CDATA 部分指定数据值。如果您使用 CDATA 部分，不对特殊字符进行转义。

  • 对 CDATA 部分以外的数据值使用转义码，包括 网址。您可以使用实体代码或字符代码来表示 这些特殊字符。 下表列出了您可以使用的常见实体代码和字符代码：

    字符 实体 字符代码
    和号 (&) &amp; ；
    英文单引号 (') &apos; ；
    英文双引号 (") &quot; &#34;
    大于 (>) &gt; &#62;
    小于 (<) &lt; &#60;

  • 省略不包含数据的 XML 元素。例如，如果您没有 酒店的经纬度，那么您不应将 <latitude/> 和 <longitude/> 元素。

  • 在任何情况下都不要在 XML 元素中使用 HTML（即使 转义）。

  • 要在上传之前验证 Feed，您可以使用本地 Feed XSD http://www.gstatic.com/localfeed/local_feed.xsd.

  • 如需在 Feed 中使用评论，请将评论封装在 <!-- 和 --> 标记中， 如下例所示：

    <!-- This is a comment -->

  • 请务必关闭用户中的 <date> 元素 <review>。例如：

    <date day="2" month="12" year="2017"/>