餐點計畫內容
詳細了解在 API 中回傳餐點計畫內容的方式。
在 API 中回傳餐點計畫內容的方式
您可以回傳不同等級的餐點計畫，這也會對它們的意義產生重大影響。它們可以回傳為房價設施服務、旅宿設施服務或內容，在某些情況下亦可回傳為額外設施服務促銷。有關房價和旅宿設施服務的完整清單，請參閱「內容參考清單」。
房價計畫設施服務
**請注意：**內容回應中也可以看到房價設施服務。但是，如要查看有關房價設施服務的最新資訊，合作夥伴應該從購物回應而非內容回應中，取得餐點內容和其他房價設施服務。
在「內容參考清單」中，這些項目是列在 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"
],旅宿設施服務
在「內容參考清單」中，這些項目是列在 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「Free Breakfast」。
注意： 與顯示房價計畫所含內容的房價計畫便利設施不同，飯店便利設施顯示的是飯店所提供的服務，且不一定是免費的。例如，屬性 361‘提供早餐（收費）’。
全包
旅宿的房價計畫可能部分或全數為全包。這些詳細資料會列在 Rapid 內容回應的 all_inclusive 部分。
所有房價計畫均為全包
如果是 all_rate_plans: true，即使沒有任何房價計畫設施服務是設為「all-inclusive」，該旅宿的所有房價計畫均會是全包。
"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 集團不會出售房源名稱中帶有「全包」字樣的房源，除非該房源的所有房價方案均為全包。此外，內容回應中的旅宿類別可能會顯示旅宿類別 8「全包物業」。請在此處查看旅宿類別的完整清單。
部分房價計畫為全包
如果是 some_rate_plans: true，則那些為全包的房價計畫，其房價計畫設施服務將會是 2111「all-inclusive」，但其飯店名稱中不會含有「all inclusive」，住宿類別也不會是「all-inclusive property」。
全包的限制條件
全包的限制條件，例如房價計畫不包含酒精飲料，會列於 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
}
}
},特殊額外設施服務
作為特別優惠一部分的房價計劃可能具有房價等級和飯店等級的內容，其中包括有關優惠的附加資訊和限制。這些列在內容回應中傳回的自由文字欄位 rates.special_offer_description、checkin.special_instructions 或 policies.know_before_you_go 中。
有多種保單可適用於增值。一些例子包括：
- 某些顧客需支付額外附加費，例如根據實際旅客人數、旅客年齡或床位共享設定。
- 免費餐飲方案不包含飲料。
- 需要預訂才能獲得
breakfastLimited時間，例如早餐僅在特定時段或特定日期提供。 - 國籍受限制。
- 特殊用餐場所，例如不在飯店內的餐廳。
- 特殊食物類型，例如僅限素食。
範例：
{
"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>"
}
}
}
}