属性

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

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

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

  • 必需的 XML 子元素：id、name、latitude、longitude、address。
  • 必需属性：capacity 和 website。

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

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

最后，当 Google 从其他来源确定属性的值与民宿商家信息的 Feed 中指定的值不同时，将会显示商家信息的值。例如，如果我们根据商家信息的照片确定它设有厨房，但 kitchen 属性不存在或设置为 No，我们就会将商家信息视为具有厨房。这些属性称为“推断属性”，只有在我们非常确信推断的准确性时才会显示它们。

attribute_name 占位符的值

下表提供了 <client_attr name="attribute_name"> 元素中 attribute_name 的有效值列表；不过，我们建议合作伙伴提供他们可能具有的任何其他 attribute_name。

attribute_name 的值 是否必需？ 说明 有效的内容值
capacity Required 酒店可容纳的人数上限。此值应等于或大于“卧室数量”。 Non-negative integer
website Required 资源的网站网址。 Free text
min_days_between_stays Optional (strongly recommended) 租金的最短“缓冲天数”必须为空（在之前的入住者离开后）。 Non-negative integer
enhanced_cleaning_practices Optional (strongly recommended) 酒店是否采用了增强型清洁做法，并在合作伙伴网站上附有说明。 Yes/No/Unknown
partner_hygiene_link Optional (strongly recommended) 指向外部合作伙伴网站的链接，该网站提供了与商家信息的健全度详情有关的更多信息。 Free text (the site's URL)
number_of_bathrooms Optional (strongly recommended) 浴室数量。 Non-negative float value, for example, 1, 1.5, 2
number_of_bedrooms Optional (strongly recommended) 卧室数。 Non-negative integer value
number_of_beds Optional (strongly recommended) 所有房间的床数。 Non-negative integer value
self_checkin_checkout Optional (strongly recommended) 酒店是否允许自助入住和退房。 Yes/No/Unknown
rating Optional (strongly recommended) 一个浮点数，表示总体房源评分。此数字通常介于 0-5、0-10 或 0-100 之间，但您可以使用任何能代表您的分级制度的范围。 Non-negative float value
rating_num Optional (strongly recommended) 房源的评分数量。 Non-negative integer
ac Optional 房源是否有空调。 Yes/No/Unknown
airport_shuttle Optional 主机提供往返机场或其他航站楼的交通服务。 Yes/No/Unknown
balcony Optional 房源是否有阳台。 Yes/No/Unknown
beach_access Optional 酒店是否可通往酒店附近的公共海滩。 Yes/No/Unknown
check_in_time Optional 在一天中入住的确切时间。接受 HHMM、HH:MM 或 HH:MM:SS 格式；例如，使用 14:00，而非 2pm 或 2:00pm。系统不会解析或显示所有其他格式。 Time
check_out_time Optional 在酒店退房的确切时间。接受 HHMM、HH:MM 或 HH:MM:SS 格式；例如，使用 11:00，而非 11am 或 11:00am。系统不会解析或显示所有其他格式。 Time
child_friendly Optional 房源是否适合儿童。 Yes/No/Unknown
crib Optional 房源是否提供婴儿床。 Yes/No/Unknown
elevator Optional 房源是否有电梯。 Yes/No/Unknown
fire_place Optional 房源是否有壁炉。 Yes/No/Unknown
free_breakfast Optional 酒店是否提供免费早餐。 Yes/No/Unknown
gym_fitness_equipment Optional 酒店设有健身房或任何健身器材。 Yes/No/Unknown
heating Optional 房源是否有供暖。 Yes/No/Unknown
hot_tub Optional 房源是否有热水浴缸。 Yes/No/Unknown
instant_bookable Optional 酒店是否可在结账过程中即时预订。备选方案正在等待审批。 Yes/No/Unknown
ironing_board Optional 房源是否提供熨衣板。 Yes/No/Unknown
kitchen Optional 房源是否有厨房。 Yes/No/Unknown
license_num Optional 对于世界某些地区的房源，必须提供营业执照（旅游或商家）。您可以重复添加该标记；如果存在多个许可，我们建议您添加许可授权机构，例如：“Paris: 123456ABC”。 Free text
microwave Optional 房源是否有微波炉。 Yes/No/Unknown
minimum_days_advance_purchase Optional 酒店可预订的最短提前天数。 Non-negative integer
minimum_night_stay Optional 房客可以预订酒店的最低住宿晚数。 Positive integer (more than zero)
max_night_stay Optional 房客可以预订酒店的最长住宿晚数。 Positive integer (more than zero)
number_of_living_rooms Optional 客厅数量。 Non-negative integer value
outdoor_grill Optional 房源是否有烧烤架。 Yes/No/Unknown
oven_stove Optional 房源是否有炉子。 Yes/No/Unknown
parking_type Optional 房源提供的停车位类型。 Free/Paid/None
patio Optional 房源是否有露台。 Yes/No/Unknown
pets_allowed Optional 部分或所有客房允许房客携带宠物（狗或不属于服务型动物的猫）随身携带。 Yes/No/Unknown
pool_type Optional 房源拥有的池类型（池访问权限）。 Indoors, Outdoors, Indoors/Outdoors, None
private_beach_access Optional 房源是否有专属非公共海滩。 Yes/No/Unknown
room_type Optional 与 Google 共享的房源的类型。

注意：目前只接受整个地点。

 Entire Place, Shared room, Private Room
smoking_free_property Optional 酒店是否禁止吸烟或禁止吸烟。 Yes/No/Unknown
square_footage Optional 房源面积（以平方英尺为单位）。 Non-negative float value
square_meters Optional 房源面积（以平方米为单位）。 Non-negative float
tv Optional 房源是否有电视。 Yes/No/Unknown
washer_dryer Optional 房源是否提供洗衣机。 Yes/No/Unknown
wheelchair_accessible Optional 房源是否轮椅无障碍。 Yes/No/Unknown
internet_type Optional 房源提供的 Wi-Fi 上网类型。 Free/Paid/None
host_language Optional 主持人可以使用的语言。 以英文逗号分隔的语言代码列表；例如：de, en

XML 子元素

以下 XML 子元素是必需的：

子元素 是否必需？ 类型 说明
<country> Optional (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 等 GeoCoding 工具生成。
<longitude> Required float 与商家信息中所列位置对应的经度，例如： 
    <longitude>-122.090101</longitude>

此值可使用 Google Maps API 等 GeoCoding 工具生成。
<name> Required string 属性的名称。最多 300 个字符。
<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>

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

民宿商家信息示例

<?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="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="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="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="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="smoking_free_property">Yes</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>