就餐计划包含情况
详细了解 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。此外，内容响应中的住宿类别可能会显示住宿类别 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中。
有多种政策可适用于增值。一些示例包括：
- 根据实际旅客人数、旅客年龄或 bed-sharing 设置，某些客户需支付额外附加费 e.g。
- 免费餐饮计划中不包含饮料。
- 需要预订才能获得
breakfastLimited时间 e.g。早餐仅在特定时段或特定日期供应。 - 国籍受限制。
- 特别餐饮场所 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>"
}
}
}
}