本页将介绍属性和子元素的说明、值和要求。这些值仅适用于民宿房源。
常规 XML 结构的格式与酒店商家信息 Feed 的格式类似。请参阅酒店列表 XML 参考文档。
如果未包含以下必需项,系统将自动停用相应商品详情。
- 必需的 XML 子元素:
id
、name
、latitude
、longitude
、address
。 - 必需属性:
capacity
和website
。- 请参阅酒店信息 Feed 中指向媒体资源的直接网站链接。这让用户有机会访问媒体资源网站。
如需详细了解必需的 XML 子元素,请参阅 XML 子元素。
如需详细了解民宿,请参阅民宿的独有属性。
最后,当 Google 从其他来源确定属性的值与民宿商家信息的 Feed 中指定的值不同时,将会显示商家信息的值。例如,如果我们根据商家信息的照片确定它设有厨房,但 kitchen
属性不存在或设置为 No
,我们就会将商家信息视为具有厨房。这些属性称为“推断属性”,只有在我们非常确信推断的准确性时才会显示它们。
attribute_name 占位符的值
下表提供了 <client_attr name="attribute_name">
元素中 attribute_name
的有效值列表;不过,建议您提供额外的 attribute_name
(如果有)。
attribute_name 的值 |
是否必需? | 说明 | 有效的内容值 |
---|---|---|---|
capacity | Required | 酒店可容纳的人数上限。此值应等于或大于“卧室数量”。 | 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 | 房源可能的最高评分 | 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,而非 2pm 或 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 |
minimum_days_advance_purchase | Recommended | 酒店可预订的最短提前天数。 | Non-negative integer value |
minimum_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 |
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 国家/地区代码;例如,美国是 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 | 房源的完整实际位置。 该元素接受一个属性 您至少必须提供房源的街道地址、城市、州/省/自治区/直辖市或区域以及邮政编码。使用
例如: <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>