属性

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

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

如果没有添加以下必需项，则系统将自动停用商品详情。

  • 必需的 XML 子元素：id、name、latitude、longitude。
  • 必需属性：capacity 和 website。
  • 可选（强烈建议）XML 子元素：location_precision - 默认值为 500 米。

如需详细了解所需的 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 工具生成。
<location_precision> Optional (strongly recommended) integer 对房源纬度和经度进行混淆处理时，所发送的房源位置的精确度（以米为单位，通常为 500 米或更多）。 默认值为 500 米。零表示未经过混淆处理，表示这是确切位置，如果精确到 100 米以内，则视为精确位置。

此元素仅适用于民宿。
<name> Required string 属性的名称。最多 300 个字符。

民宿商家信息示例

<?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">Detailed Address</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>
    <location_precision>500</location_precision>
    <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>