就餐计划包含情况
详细了解 API 中如何返回就餐计划包含情况。
API 中如何返回就餐计划包含情况
就餐计划可在不同的级别返回,这对就餐计划含义的影响很大。就餐计划可作为房价服务/设施、住宿服务/设施、内容进行返回,在某些情况下还可作为增值促销项目进行返回。如需查看房价和住宿服务设施的完整列表,请参阅内容参考列表。
房价计划服务设施
注意:在内容响应中可能也会看到房价服务设施。不过,要了解房价包含的服务/设施的最新信息,合作伙伴应从选购响应(而非内容响应)中了解房价中的就餐及其他服务设施包含情况。
在[内容参考列表] (lodging/content/content-reference-lists) 中,这些信息位于 amenities_rates 下。
常见的房价计划服务/设施如下:
- 1073742786 - 免费早餐
- 2194 - 双早
- 2205 - 自助早餐
- 2206 - 含两餐
- 2111 - 全包
您可以在快速可用性响应中查看套餐优惠信息。除非另有说明,所有预订客人的餐食均包含在内。说明可以以设施名称(例如,“双人早餐”)、房间类型名称、酒店描述或价格描述的形式返回。更多详情请参阅下方的特殊增值部分。
"amenities": {
"1073742857": {
"id": "1073742857",
"name": "Breakfast for 1"
},
"1073742617": {
"id": "1073742617",
"name": "Disney park tickets"
},
"2192": {
"id": "2192",
"name": "Free WiFi"
}
},在 Rapid 行程检索响应中也可看到房价计划包含的服务设施:
"rate": {
"id": "384339493",
"merchant_of_record": "expedia",
"refundable": true,
"amenities": [
"2109",
"2192",
"1073742786"
],住宿服务设施
在[内容参考列表] (lodging/content/content-reference-lists) 中,这些信息位于 amenities_property 下。
在 Rapid 内容响应中可看到住宿服务设施:
"amenities": {
"2387": {
"id": "2387",
"name": "Tours/ticket assistance"
},
"4467": {
"id": "4467",
"name": "Beach towels"
},
"56": {
"id": "56",
"name": "Airport transportation (surcharge)"
},
"4003": {
"id": "4003",
"name": "Luggage storage"
},
"2001": {
"id": "2001",
"name": "Free breakfast"
},
"2386": {
"id": "2386",
"name": "Grocery/convenience store"
}
},免费早餐(属性 2001)酒店设施意味着酒店的所有客房和房价计划均包含免费早餐。这会在 Rapid 选购响应中在房价级别以属性 1073742786“免费早餐”进行复制。
注意: 与显示价格计划包含内容的设施不同,物业设施显示的是物业提供的服务,这些服务不一定是免费的。E.g。属性 361'提供早餐(需额外收费)。
全包
住宿的房价计划可能部分或全部为全包房价计划。此类详细信息位于 Rapid 内容响应的 all_inclusive 部分。
所有房价计划均为全包
如果 all_rate_plans: true 为 true,则相应住宿的所有房价计划均为全包,即使没有“全包”房价计划服务设施。
"all_inclusive": {
"all_rate_plans": true,
"details": "This property is all-inclusive. Onsite food and beverages are included in the room price (some restrictions may apply). <strong>Gratuities and taxes</strong>
Gratuities and taxes are included. Additional gratuities at guests' discretion are accepted. <strong>Food and beverages</strong><ul><li>All buffet and à la carte meals, snacks, and beverages included</li><li>In-room minibar (some restrictions)</li><li>Limited gourmet or à la carte dining</li></ul> <strong>Activities and facilities/equipment</strong>
All non-motorized water sports, land activities, and use of recreational facilities and equipment are included.
Water activities<ul><li>Snorkeling</li><li>Windsurfing</li></ul>
Land activities<ul><li>Bicycling</li><li>Fitness facilities</li><li>Tennis</li><li>Tennis lessons</li><li>Volleyball</li><li>Access to golf course</li></ul>
Lessons/classes/games <ul><li>Aerobics</li><li>Dancing</li><li>Language</li></ul> <strong>Kids' club</strong><ul><li>Supervised activities for children between 4 and 12 years old</li></ul> <strong>Not included</strong><ul><li>Golf green fees</li><li>Use of golf cart</li><li>Use of golf equipment</li><li>Motorized water sports</li><li>Scuba-diving certification</li><li>Tennis racquets</li><li>Premium food items</li><li>Premium/non-domestic alcoholic beverages</li><li>Childcare</li><li>Spa/beauty facilities and services</li></ul>",
"some_rate_plans": false
},)其他可以表明所有房价计划均为全包的依据是,住宿名称中显示“全包”字样。Expedia Group 不会出售名称中带有“all inclusive”字样的房产,除非该房产的所有费率计划都是 all-inclusive。此外,内容响应中的住宿类别可能会显示住宿类别 8“全包住宿” 查看完整的房产类别列表。
部分房价计划为全包
如果 some_rate_plans: true为 true,全包房价计划将具有房价计划服务设施 2111“全包”。酒店名称不会带有“全包”,住宿类别也不会是“全包式住宿”。
全包的限制条件
可在 all_inclusive 响应的 details 值中查看全包的限制条件,例如房价计划中不包含酒精饮料。
示例:
"all_inclusive": {
"all_rate_plans": false,
"details": "<em>All-inclusive</em> room rates at Solymar Naama Bay are available. These rates are higher because they include onsite food and beverages in the room rate (some restrictions may apply). <strong>Gratuities and taxes</strong>
Gratuities and taxes are included. Additional gratuities at guests' discretion are accepted. <strong>Food and beverages</strong><ul><li>Buffet meals, snacks, and select beverages included</li><li>Basic alcoholic beverages included</li><li>Dining availability limited at one or more venues</li></ul> <strong>Activities and facilities/equipment</strong>
Lessons/classes/games <ul><li>Dancing</li></ul> <strong>Entertainment</strong><ul><li>Onsite entertainment and activities</li></ul> <strong>Not included</strong><ul><li>Motorized water sports</li><li>Premium/non-domestic alcoholic beverages</li><li>Activities and services offered by independent operators</li></ul>",
"some_rate_plans": true增值项目促销
在某些情况下,在选购响应中可能还会看到作为增值促销项目显示的就餐计划包含情况。
示例:
"promotions": {
"value_adds": {
"287248": {
"id": "287248",
"description": "Free dinner for 2 per day",
"category": "food_and_beverage",
"offer_type": "free",
"frequency": "per_day",
"person_count": 2
}
}
}在 Rapid 行程检索响应中也可看到增值促销项目。
示例:
"rate": {
"id": "209136450",
"merchant_of_record": "expedia",
"refundable": true,
"amenities": [
"2192"
],
"promotions": {
"value_adds": {
"279553": {
"id": "279553",
"description": "Free continental breakfast for 2 per day",
"category": "food_and_beverage",
"offer_type": "free",
"frequency": "per_day",
"person_count": 2
}
}
},特殊增值项目
特价优惠套餐可能包含 rate-level 和 property-level 内容,其中包含有关优惠的附加信息和限制。这些内容列在内容响应中返回的自由文本字段 rates.special_offer_description、checkin.special_instructions 或 policies.know_before_you_go中。
有多种政策可能适用于增值服务。例如:
- 部分客户需支付额外附加费 e.g。具体费用取决于实际旅客人数、旅客年龄或 bed-sharing 设置。
- 免费餐费套餐不包含饮料。
- 需要提前预订才能享用早餐。早餐仅在特定时间或特定日期供应。
breakfastLimited - 国籍限制。
- 特色餐饮场所 e.g。一家不在酒店内的餐厅。
- 特殊食品类型 e.g。仅限素食。
示例:
{
"12345": {
"property_id": "12345",
...
"checkin": {
"begin_time": "3:00 PM",
"end_time": "midnight",
"instructions": "<ul> <li>Extra-person charges may apply and vary depending on property policy</li><li>Government-issued photo identification and a credit card or cash deposit may be required at check-in for incidental charges</li><li>Special requests are subject to availability upon check-in and may incur additional charges; special requests cannot be guaranteed</li><li>This property accepts credit cards; cash is not accepted</li><li>Safety features at this property include a smoke detector</li><li>Please note that cultural norms and guest policies may differ by country and by property; the policies listed are provided by the property</li> </ul>",
"special_instructions": "This property doesn't offer after-hours check-in. Front desk staff will greet guests on arrival. For more details, please contact the property using the information on the booking confirmation. Additional fees apply to children 0 to 12 years old for breakfast. Breakfast is not included in the breakfast rate plans for children ages 6-12, and can be requested onsite for the listed child breakfast fee.",
"min_age": 18
},
...
"policies": {
"know_before_you_go": "<ul> <li>Up to 2 children 5 years old and younger stay free when occupying the parent or guardian's room, using existing bedding. </li><li>The Japanese Ministry of Health, Labour, and Welfare requires all international visitors to submit their passport number and nationality when registering at any lodging facility (inns, hotels, motels, etc. ). Additionally, lodging proprietors are required to photocopy passports for all registering guests and keep the photocopy on file. </li> </ul>"
},
...
"rates": {
"201510380": {
"id": "201510380",
"amenities": { ... },
"special_offer_description": "<strong>Stay for Breakfast</strong> Book a stay in this rate plan and receive breakfast for 2 adults and children under 12 years old registered in the same room. <em>Full details at check-in. Restrictions may apply.</em>"
}
}
}
}