属性

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

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

如果未添加以下必需项，商家信息会自动停用：

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

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

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

最后，如果 Google 从其他来源确定某个属性的值与民宿商家信息 Feed 中指定的值不同，则会显示该商家信息的值。例如，如果 Google 根据商家信息的照片确定其有厨房，但 kitchen 属性不存在或设为 No，Google 会将该商家信息视为有厨房。这些属性称为“推断属性”，只有在推理准确性有较高把握时，系统才会显示这些属性。

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，房源评分应为 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:00 下午。系统不会解析或显示所有其他格式。 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 在全球某些地区需要显示的房源许可号码（游客或商家）。如果存在多个许可，可以重复添加，我们建议添加许可授权机构作为背景信息；例如：“Paris: 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 标准国家/地区代码（由 2 个字母组成）；例如，美国的代码为 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>