属性

本页介绍了属性和子元素的说明、值和要求。这些值仅适用于民宿房源。

常规 XML 结构的格式与酒店信息 Feed 类似。请参阅酒店列表 XML 参考。

如果未包含以下必需项，系统会自动停用相应商品详情：

  • 必需的 XML 子元素：id、name、latitude、longitude、address。
  • 必需属性：capacity 和 website。请参阅酒店信息 Feed 中的民宿直接链接。这样，用户就有机会访问酒店网站。

如需详细了解必需的 XML 子元素，请参阅 XML 子元素。

如需详细了解民宿，请参阅民宿特有的属性。

最后，当 Google 从其他来源确定属性的值与民宿房源信息的 Feed 中指定的值不同时，Google 会显示该房源信息的值。例如，如果 Google 从房源的照片中确定该房源有厨房，但 kitchen 属性缺失或设置为 No，Google 会将该房源视为有厨房。这些属性称为“推断属性”，只有在推断准确度较高时才会显示。

<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 评价类型。设置为以下值之一：
  • editorial：网站或其他审核机构的评价。
  • user：最终用户的评价。

子元素

<review> 元素具有以下子元素：

子元素 是否必需？ 类型 说明
<link> Optional string 评价的链接。在此元素中添加“http://”或“https://”。
<title> Optional string （仅限编者评价）评价的标题。
<author> Optional string 评价的作者；例如，“Susan von Trapp”。如果评价未署名，也可以是显示评价的网站或出版物的名称。
<rating> Optional string 一个介于 0 到 10（含）之间的浮点数，表示评价的分数。例如，“8.9”。
<body> Optional string 评价的文本。此元素不应包含 HTML。
<date month="MM" day="DD" year="YYYY"/> Optional Object （仅限用户评价）评价的日期，您可以使用此元素的以下属性指定该日期：
  • 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>，则可能不会显示。无需填写日期。

示例

以下示例显示了部分酒店列表，其中包含一条包含编辑评价和用户评价的酒店详情：

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

attribute_name 占位符的值

下表列出了 <client_attr name="attribute_name"> 元素中 attribute_name 的有效值；不过，建议您尽可能提供其他 attribute_name。

attribute_name 的值 是否必需？ 说明 有效的内容值
capacity Required 房源可容纳的最多房客人数。此值应等于或大于“number_of_bedrooms”。 Non-negative integer value
website Required 相应媒体资源的网站网址。 Free text
partner_hygiene_link Strongly recommended 指向外部合作伙伴网站的链接，其中提供了有关房源卫生详情的更多信息。 Free text (the site's URL)
number_of_bathrooms Strongly recommended 浴室数量。 Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms Strongly recommended 卧室数量。 Non-negative integer value
number_of_beds Strongly recommended 所有房间的床位数。 Non-negative integer value
self_checkin_checkout Recommended 房源是否支持自助入住和退房。 Yes/No/Unknown
rating Strongly recommended 表示房源总评分的浮点数。此数字通常介于 0-5、0-10 或 0-100 之间，但您可以使用任何表示评分系统的范围。 Non-negative float value
rating_num Strongly recommended 房源获得的评分数量。 Non-negative integer value
rating_scale Strongly recommended 房源的最高可能评分。例如，如果 rating_scale 为 5，则 property rating 应为 3 或 4。

注意：如果未指定，默认 rating_scale 为 0-10。

Non-negative integer value
instant_bookable Strongly recommended 房源是否可通过退房流程立即预订。 备用选项是等待批准。 Yes/No/Unknown
description Strongly recommended 用于描述房源独特品质的自由格式文本 Free text
category Strongly recommended 房产类型，例如别墅、平房、小木屋或公寓 Free text
ac Recommended 房源是否有空调。 Yes/No/Unknown
beach_access Recommended 房源是否可通往房源附近的公共海滩。 Yes/No/Unknown
check_in_time Recommended 入住酒店的确切时间。接受 HHMM、HH:MM 或 HH:MM:SS 格式；例如，使用 14:00 而不是下午 2 点或 2:00pm。系统不会解析或显示所有其他格式。 Time
check_out_time Recommended 退房的确切时间。接受 HHMM、HH:MM 或 HH:MM:SS 格式；例如，使用 11:00 而不是 11am 或 11:00am。系统不会解析或显示所有其他格式。 Time
child_friendly Recommended 房源是否适合儿童。 Yes/No/Unknown
crib Recommended 房源是否提供婴儿床。 Yes/No/Unknown
elevator Recommended 房源是否有电梯。 Yes/No/Unknown
gym_fitness_equipment Recommended 房源是否有健身房或任何健身器材。 Yes/No/Unknown
heating Recommended 房源是否有供暖。 Yes/No/Unknown
hot_tub Recommended 房源是否有热水浴缸。 Yes/No/Unknown
ironing_board Recommended 房源是否提供熨衣板。 Yes/No/Unknown
kitchen Recommended 房源是否有厨房。 Yes/No/Unknown
microwave Recommended 房源是否有微波炉。 Yes/No/Unknown
min_days_advance_purchase Recommended 可预订房源的最少提前天数。 Non-negative integer value
min_night_stay Recommended 客人可以预订该房源的最少晚数。 Positive integer (more than zero)
max_night_stay Recommended 客人可以预订房源的最长晚数。 Positive integer (more than zero)
outdoor_grill Recommended 房源是否有烧烤架。 Yes/No/Unknown
oven_stove Recommended 房源是否有炉灶。 Yes/No/Unknown
parking_type Recommended 房源提供的停车类型。 Free/Paid/None
patio Recommended 房源是否有露台。 Yes/No/Unknown
pets_allowed Recommended 部分或所有客房允许房客携带宠物（非服务型动物）入住，包括狗或猫。 Yes/No/Unknown
pool_type Recommended 房源拥有的泳池（可使用泳池）类型。 Indoors, Outdoors, Indoors/Outdoors, None
room_type Recommended 房间类型。ENTIRE_PLACE 是唯一支持的值。 ENTIRE_PLACE
smoking_free_property Recommended 房源是否禁烟。 Yes/No/Unknown
special_service_level Recommended 相应房源的服务级别是否特殊。 例如，verified、luxury、premium Yes/No/Unknown
square_footage Recommended 房源的面积（以平方英尺为单位）。 Non-negative float value
square_meters Recommended 房产的面积（以平方米为单位）。 Non-negative float
tv Recommended 房源是否有电视。 Yes/No/Unknown
washer_dryer Recommended 房源是否提供洗衣机。 Yes/No/Unknown
wheelchair_accessible Recommended 房源是否轮椅无障碍。 Yes/No/Unknown
internet_type Recommended 房源提供的 Wi-Fi 上网服务类型。 Free/Paid/None
airport_shuttle Optional 房主是否提供往返机场或其他交通站点的交通服务。 Yes/No/Unknown
balcony Optional 房源是否有阳台。 Yes/No/Unknown
fire_place Optional 房源是否有壁炉。 Yes/No/Unknown
free_breakfast Optional 房源是否包含免费早餐。 Yes/No/Unknown
host_description Optional 度假出租屋房东的说明。 Free text
host_language Optional 屋主可以使用的语言。 以英文逗号分隔的语言代码列表；例如：de、en
host_name Optional 民宿房东的名称。 Free text
host_response_rate Optional 房东的平均回复率。 Non-negative float value, for example, 1, 0.75, 0.5
host_response_time Optional 房东的平均回复时间。 Free text
license_num Optional 在全球某些地区需要显示的房源许可号码（游客或商家）。如果存在多个许可，可以重复添加，我们建议添加许可授权机构作为背景信息；例如：“巴黎：123456ABC”。 Free text
number_of_half_bathrooms Optional 半浴室的数量。 Non-negative integer value
number_of_living_rooms Optional 起居室数量。 Non-negative integer value
private_beach_access Optional 房源是否有专属非公共海滩。 Yes/No/Unknown
refund_policy Optional 相应房源的退款政策。 Free text

XML 子元素

以下 XML 子元素是必需的：

子元素 是否必需？ 类型 说明
<country> Strongly recommended string 相应房源所在的国家/地区。该值必须是由两个字母组成的 ISO 3116 标准国家/地区代码；例如，美国是 US，加拿大是 CA： 
    <country>US</country>
<id> Required string 房源的唯一标识符。请注意，每套度假租赁房源都必须具有您网站独有的 ID，并且此 ID 绝不应重复使用。
<latitude> Required float 与商家信息中所列位置对应的纬度，例如：
    <latitude>37.423738</latitude>

此值可以使用地理编码工具（例如 Google Maps API）生成。
<longitude> Required float 与商家信息中所列位置对应的经度，例如：
    <longitude>-122.090101</longitude>

此值可以使用地理编码工具（例如 Google Maps API）生成。
<name> Required string 相应属性的名称。不得超过 300 个字符。
<address> Required string or Object

房源的完整实际位置（以字符串形式表示）。地址必须包含街道名称和门牌号。如果不存在，则地址应包含 Plus Code。如果适用，还必须添加公寓号或单元号。

或者，您也可以提供“复合”地址。使用 <component> 子元素来描述地址的以下各个部分：

  • addr1：主要街道地址。
  • addr2：次要街道地址（包括单元号，如有必要）。
  • city：城市。
  • province：如果需要，则为州、地区或省份。
  • postal_code：邮政编码。
  • country：国家/地区。

请注意，邮政信箱或其他仅限邮寄的地址不属于完整的实际地址。

以下是完整地址的示例：

<address>6 Acacia Ave Apt. 2, Nottingham NG8 6FT, UK/address>
 
<address>
  <component name="addr1">6 Acacia Ave</component>
  <component name="addr2">Apt. 2</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

以下是使用 Plus 代码的完整地址示例：

<address>XQHM+7VF Nottingham NG8 6FT, UK/address>
 
<address>
  <component name="addr1">XQHM+7VF</component>
  <component name="city">Nottingham </component>
  <component name="postal_code">NG8 6FT</component>
  <component name="country">UK</component>
</address>

请避免以下情况：

  • 冗余信息：请勿添加无关信息或重复的地址组成部分。
  • 缺少街道地址：地址必须包含街道名称和门牌号。

民宿商家信息示例

<?xml version="1.0" encoding="UTF-8"?>
<listings>
  <language>en</language>
  <listing>
    <id>123456</id>
    <name>Apartment Name</name>
    <address format="simple">
      <component name="addr1">18733 Clark Way</component>
      <component name="addr2">#C10</component>
      <component name="city">Mountain View</component>
      <component name="postal_code">94043</component>
      <component name="province">California</component>
    </address>
    <country>US</country>
    <latitude>37.4182515</latitude>
    <longitude>-122.0742354</longitude>
    <phone type="main">12345678</phone>
    <category>vacation_villa</category>
    <date day="21" month="12" year="2017"/>
    <content>
      <text type="description">
        <link>https://list_url</link>
        <title>Description Title</title>
        <body>Description Body</body>
      </text>
      <review type="editorial">
        <link>https://example.com/reviews/42</link>
        <title>A little piece of heaven</title>
        <author>EXAMPLE</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="2017"/>
        <servicedate day="16" month="6" year="2017"/>
      </review>
      <attributes>
        <website>https://hotel.example.com/123456</website>
        <client_attr name="capacity">7</client_attr>
        <client_attr name="cleaning_disinfection">Yes</client_attr>
        <client_attr name="min_days_between_stays">3</client_attr>
        <client_attr name="enhanced_cleaning_practices">Yes</client_attr>
        <client_attr name="partner_hygiene_link">http://www.example.com/hygiene/</client_attr>
        <client_attr name="number_of_bathrooms">2</client_attr>
        <client_attr name="number_of_bedrooms">3</client_attr>
        <client_attr name="number_of_beds">4</client_attr>
        <client_attr name="self_checkin_checkout">Yes</client_attr>
        <client_attr name="rating">4.8</client_attr>
        <client_attr name="rating_num">5373</client_attr>
        <client_attr name="rating_scale">5</client_attr>
        <client_attr name="ac">Yes</client_attr>
        <client_attr name="airport_shuttle">Yes</client_attr>
        <client_attr name="balcony">No</client_attr>
        <client_attr name="beach_access">Yes</client_attr>
        <client_attr name="check_in_time">15:00</client_attr>
        <client_attr name="check_out_time">11:00</client_attr>
        <client_attr name="child_friendly">Yes</client_attr>
        <client_attr name="crib">Unknown</client_attr>
        <client_attr name="elevator">Yes</client_attr>
        <client_attr name="fire_place">Unknown</client_attr>
        <client_attr name="free_breakfast">Yes</client_attr>
        <client_attr name="gym_fitness_equipment">Yes</client_attr>
        <client_attr name="heating">Yes</client_attr>
        <client_attr name="host_description">A short description about the host and their interests</client_attr>
        <client_attr name="host_name">The name of the host</client_attr>
        <client_attr name="host_language">en, da, el</client_attr>
        <client_attr name="host_response_rate">0.75</client_attr>
        <client_attr name="host_response_time">1 hour</client_attr>
        <client_attr name="hot_tub">Yes</client_attr>
        <client_attr name="instant_bookable">Yes</client_attr>
        <client_attr name="internet_type">Free</client_attr>
        <client_attr name="ironing_board">No</client_attr>
        <client_attr name="kitchen">Yes</client_attr>
        <client_attr name="license_num">Free text. If multiple licenses exist, we suggest adding authority of the licence as context</client_attr>
        <client_attr name="license_num">Paris: 123456ABC</client_attr>
        <client_attr name="microwave">Yes</client_attr>
        <client_attr name="max_night_stay">7</client_attr>
        <client_attr name="min_days_advance_purchase">2</client_attr>
        <client_attr name="min_night_stay">3</client_attr>
        <client_attr name="number_of_living_rooms">1</client_attr>
        <client_attr name="outdoor_grill">No</client_attr>
        <client_attr name="oven_stove">Yes</client_attr>
        <client_attr name="parking_type">Free</client_attr>
        <client_attr name="patio">Unknown</client_attr>
        <client_attr name="pets_allowed">Yes</client_attr>
        <client_attr name="pool_type">Indoors</client_attr>
        <client_attr name="private_beach_access">Unknown</client_attr>
        <client_attr name="room_type">ENTIRE_PLACE</client_attr>
        <client_attr name="refund_policy">The refund policy for the property</client_attr>
        <client_attr name="smoking_free_property">Yes</client_attr>
        <client_attr name="special_service_level">No</client_attr>
        <client_attr name="square_footage">1200</client_attr>
        <client_attr name="tv">Yes</client_attr>
        <client_attr name="washer_dryer">Yes</client_attr>
        <client_attr name="wheelchair_accessible">Yes</client_attr>
      </attributes>
    </content>
  </listing>
</listings>