餐點計畫內容
詳細了解在 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」。
註： 與房價方案所含設施不同，旅宿設施顯示該設施可供使用的項目，且未必免費。E.g. 屬性 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 Group 除非該旅宿的所有費率方案皆為 all-inclusive，否則不得銷售名稱中含「全包式」字樣的旅宿。此外，內容回應中的旅宿類別可能會顯示旅宿類別 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
}
}
},特殊額外設施服務
屬於特別優惠方案的資費方案，其內容可能包含 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. 一家不在旅宿的餐廳。
- 特殊飲食類型：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>"
}
}
}
}