属性源引用
如果在必应中创建酒店价格广告，则必须使用属性源提供有关您宣传的酒店的必应信息。 在发送必应价格源之前，必须定义并导入属性 源。
有关创建属性源的信息，请参阅 创建属性源。
企业一览表
定义属性源的顶级元素。
| 元素 |
说明 |
Children |
| 清单 |
属性源中的顶级元素。 |
列表类型 |
列表类型
定义源中的酒店列表。
| 元素 |
说明 |
Children |
| language |
必填。
数据类型为字符串。
源中酒店数据所写入的语言。 使用双字母 ISO 639 语言代码指定语言。 例如，使用 en 表示英语。
|
None |
| 清单 |
定义酒店列表。 为源中的每个酒店添加一个 listing 元素。 |
列表类型 |
列表类型
定义酒店。
| 元素 |
说明 |
Children |
| id |
必填。
数据类型为字符串。
一个不透明的用户定义 ID，用于唯一标识源中的酒店。
创建价格源时，请在 Price 源的 元素中 Property 使用此 ID 来标识酒店。 |
None |
| name |
必填。
数据类型为字符串。
酒店的名称。 名称最多可以包含 200 个字符。 |
None |
| address |
必填。
数据类型为字符串或 组件类型。
酒店的街道地址。
注意：- 可以使用元素正文
address 中的自由格式文本指定地址，或使用 component 子元素指定地址的组件 (请参阅 组件类型) 。 - 建议使用
component 元素来指定地址的组件。 - 如果使用自由格式文本，请用逗号分隔地址的每个组件。 例如，1234 Billings Way、Redmond、WA、98030。
|
组件类型 |
| country |
必填。
数据类型为字符串。
酒店所在的国家/地区。 使用双字母 ISO 3116 国家/地区代码指定国家/地区。 例如，使用 US 进行美国。 |
None |
| latitude |
必填。
数据类型为 decimal。
酒店地理坐标的纬度。
注意：- 仅当未指定
phone时才需要纬度和经度。 最好同时指定电话和地理坐标。 - 纬度必须在 -90.0 到 90.0 的范围内。
- 使用 位置 API 或其他地理编码工具生成坐标。
|
None |
| longitude |
必填。
数据类型为 decimal。
酒店的地理坐标的经度。
注意：- 仅当未指定
phone时才需要纬度和经度。 最好同时指定电话和地理坐标。 - 经度必须介于 -180.0 到 180.0 的范围内。
- 使用 位置 API 或其他地理编码工具生成坐标。
|
None |
|
电话 |
必填。
数据类型为字符串。
客户用来联系酒店的电话号码列表。
属性：- type - 必需。 指定的电话号码类型。 下面是可能的值。
- main - 必需。 酒店main语音电话号码。
- 免收费 - 可选。 酒店的免费语音电话号码。
- fax - 可选。 酒店的传真电话号码。
- tdd - 可选。 酒店用于聋人电话号码的电信设备。
- mobile - 可选。 酒店的移动电话号码。
注意：- 仅当未指定
latitude 和 longitude时才需要电话号码。 最好同时指定电话和地理坐标。 - 为列表提供唯一的电话号码。
- 在电话号码中使用短划线、空格或括号，使其更易于阅读。 例如，使用“610-222-3333”或“ (610) 222-3333”而不是“6102223333”。
- 在每个
phone 元素中仅指定一个电话号码。 不要指定多个数字，例如 650-123-2222/33。 - 电话号码最多可包含 7 位数字的分机。 在扩展前面使用以下缩写之一：“ext”、“extn”和“x”。 例如，“408-555-1111x12345”或“408-555-1111 x12345”。
- 电话号码不能包含字母字符。
- 每个列表应指定每种类型的电话号码之一：“main”、“移动”、“免收费”、“传真”或“tdd”（如果适用）。
- 如果电话号码包含国家/地区代码，请在其前面加上“+”。 例如，“+65 6722-2323”表示新加坡国家/地区代码为 65 的数字，或“+001 (408) 555-1111”表示国家/地区代码为 001 的美国。
|
None |
| “类别” |
可选。
数据类型为字符串。
标识酒店类型的类别。 预期格式为 vacation_rental 或 hotel ，后跟管道字符和自定义值。 例如， vacation_rental |“自定义值” 或 酒店 |“自定义值”
有关自定义值的列表，请参阅 住宿属性类别。 |
None |
| content |
可选。
数据类型为 “内容类型”。
提供有关酒店的其他信息，例如描述、评论和设施。 |
Content Type |
组件类型
定义街道地址的组件。
| 元素 |
说明 |
Children |
| 元件 |
可选。
数据类型为字符串。
为地址的每个组件指定元素 component 。
属性：- name - 必需。 地址组件的名称。 下面是可能的值。
- addr1 - 必需。 酒店的街道地址。
- addr2 - 可选。 第二条街道地址线。
- addr3 - 可选。 第三条街道地址线。
- city - 必需。 酒店所在城市的名称。
- 省 - 必需。 酒店所在的州、地区或省的名称。
- postal_code - 必需。 地址的邮政编码。
|
None |
内容类型
定义有关酒店的其他信息。 (这些元素可以按任意顺序显示。)
| 元素 |
说明 |
Children |
| text |
可选。
数据类型为 “说明类型”。
酒店的说明。
属性： |
说明类型 |
| 回顾 |
可选。
数据类型为 “审阅类型”。
酒店评论。 可以指定一个或多个 <审阅> 元素。
属性：- type - 必需。 将 设置为以下类型之一：
- 社论 - 评论由博主或其他专业权威撰写。
- 用户 - 评审由用户编写。
|
审阅类型 |
| attributes |
可选。
数据类型为 属性类型。
酒店设施列表。 为要包含的每个服务指定一个 <attr> 子元素。 |
属性类型 |
| image |
可选。
数据类型为 图像类型。
酒店的图像。 可以指定一个或多个 <图像> 元素。 最佳图像纵横比为 4：3。
属性：- type - 必需。 将 设置为以下类型之一：
- ad - 图像是广告。
- menu - 图像显示酒店餐厅的菜单。
- 照片 - 图像是酒店的图像。
- url - 必需。 图像的 URL。
- width - 可选。 图像的宽度（以像素为单位）。 应大于 720 像素。
- height - 可选。 图像的高度（以像素为单位）。 应大于 720 像素。
|
图像类型 |
| 社区 |
可选。
数据类型为 “邻里类型”。
酒店所在的社区列表。 |
邻里类型 |
| brandCode |
可选。
数据类型为字符串。
与徽标关联的品牌代码。 如果对要播发的属性具有多个徽标，则使用此方法。 |
None |
说明类型
定义酒店的说明。
| 元素 |
说明 |
Children |
| 链接 |
可选。
数据类型为字符串。
酒店在线描述的 URL。 |
None |
| title |
可选。
数据类型为字符串。
要用于说明的标题。 |
None |
| body |
必填。
数据类型为字符串。
酒店的说明。 |
None |
图像类型
定义酒店的图像。
| 元素 |
说明 |
Children |
| date |
必填。
拍摄图像的日期。
属性：- month - 必需。 拍摄图像的月份。 有效值为 1 (1 月) 日至 12 月 12 日 ()
- day - 必需。 拍摄图像的月份日期。
- year - 必需。 图像拍摄的四位数年份。
|
None |
| 链接 |
可选。
数据类型为字符串。
包含图像的酒店网页的 URL。 |
None |
| title |
可选。
数据类型为字符串。
要用于图像的标题。 |
None |
| author |
可选。
数据类型为字符串。
拍摄图像的人员的姓名。 |
None |
邻里类型
定义酒店所在的邻里。
| 元素 |
说明 |
Children |
| 附近 |
可选。
数据类型为字符串。
酒店所在街区的名称。 |
None |
审阅类型
定义酒店评审。
| 元素 |
说明 |
Children |
| author |
可选。
数据类型为字符串。
撰写评论的人员的姓名。 |
None |
| body |
可选。
数据类型为字符串。
审阅的文本。 文本不应包含 HTML，但如果包含 HTML，则必须对其进行转义。 |
None |
| date |
可选。
撰写评论的日期。 仅当评审的类型为 用户时指定日期。
属性：- month - 必需。 撰写评论的月份。 有效值为 1 () 年 1 月 1 日至 12 月 12 日 (，) 年 12 月 12 日。
- day - 必需。 撰写评论的月份日期。
- year - 必需。 撰写评论的四位数年份。
|
None |
| 链接 |
可选。
数据类型为字符串。
联机评审的 URL。 |
None |
| 额定值 |
可选。
数据类型为字符串。
评论者给酒店的评分。 分级是 0.0 到 10.0 范围内的字符串十进制。 |
None |
| title |
可选。
数据类型为字符串。
评论的标题。 仅当审阅的类型为 编辑时指定标题。 |
None |
属性类型
定义酒店服务。
| 元素 |
说明 |
Children |
| website |
可选。
数据类型为字符串。
酒店网站的 URL。 |
None |
| attr |
可选。
数据类型为字符串。
酒店服务。
属性：- name - 必需。 将 设置为以下值之一：
- air_conditioned - 指示是否所有客房都装有空调。 根据需要将元素的值设置为“是”或“否”。
- all_inclusive_available - 指示房价是否包括食物和饮料。 根据需要将元素的值设置为“是”或“否”。
- child_friendly - 指示酒店是否为带孩子旅行的家庭提供特殊功能，例如降低房价、游乐区或儿童俱乐部。 根据需要将元素的值设置为“是”或“否”。
- has_affiliated_golf_course - 指示酒店是否在现场或附近设有高尔夫球场供客人使用。 根据需要将元素的值设置为“是”或“否”。
- has_airport_shuttle - 指示酒店是免费提供还是收费的机场穿梭巴士。 根据需要将元素的值设置为“是”或“否”。
- has_bar_or_lounge - 指示酒店是否有提供酒精饮料的酒吧或休息室。 根据需要将元素的值设置为“是”或“否”。
- has_beach_access - 指示酒店是否无需过马路即可进入海滩。 根据需要将元素的值设置为“是”或“否”。
- has_business_center- 指示酒店是否包括一个可免费或收费使用电脑和打印机的商务中心。 根据需要将元素的值设置为“是”或“否”。
- has_fitness_center-酒店有一个内部的健身房。 根据需要将元素的值设置为“是”或“否”。
- has_free_breakfast - 指示酒店是否每天向所有客人提供早餐。 根据需要将元素的值设置为“是”或“否”。
- has_hot_tub- 指示酒店是否设有热浴盆，部分或所有客房包括漩涡池或按摩浴缸。 根据需要将元素的值设置为“是”或“否”。
- has_laundry_service - 指示酒店是否提供洗衣店，酒店对客人的衣服进行清洗。 现场自助、投币式设施不计算在内。 根据需要将元素的值设置为“是”或“否”。
- has_restaurant - 指示酒店是否为客人提供店内餐厅。 根据需要将元素的值设置为“是”或“否”。
- has_room_service- 指示酒店是否提供在现场准备食物并送到客人房间的送餐服务。 根据需要将元素的值设置为“是”或“否”。
- has_spa - 指示酒店是否有提供按摩、面部护理或桑拿等服务的现场 Spa。 根据需要将元素的值设置为“是”或“否”。
- kitchen_availability - 指示客房是否包括带冰箱及炉子的厨房。 将元素的值设置为 “在所有会议室中可用”、“ 在某些会议室中可用”或 “不可用”。
- num_reviews - 对酒店进行评审的次数。 将元素的值设置为评论数。
- number_of_rooms - 与列表关联的单位数。 将元素的值设置为评论数。
- parking_type - 指示是否提供停车以及是否免费。 将元素的值设置为 “无需付款”、“ 已付费”或 “不可用”。
- pets_allowed - 指示酒店是否允许客人携带宠物。 将元素的值设置为“是”或“否”。
- smoke_free_property - 指示酒店是否允许吸烟。 将元素的值设置为“是”或“否”。
- star_rating - 酒店的star评级。 可能的值为 1 到 5。
- swimming_pool_type - 指示酒店是否为客人提供游泳池。 将元素的值设置为 “室内”、“ 户外”、“ 室内和户外”或 “不可用”。
- wheelchair_accessible - 指示酒店是否适合轮椅使用者。 将元素的值设置为“是”或“否”。
- wifi_type - 指示酒店是否提供 WiFi 服务。 将元素的值设置为 “无需付款”、“ 已付费”或 “不可用”。
- custom_0 - 用于不适用于其他属性的额外信息的自定义参数
- custom_1 - 用于不适用于其他属性的额外信息的自定义参数
- custom_2 - 用于不适用于其他属性的额外信息的自定义参数
- custom_3 - 用于不适用于其他属性的额外信息的自定义参数
- custom_4 - 用于不适用于其他属性的额外信息的自定义参数
|
无 |