餐點計畫內容
詳細了解在 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>"
}
}
}
}