餐點計畫內容
詳細了解在 API 中回傳餐點計畫內容的方式。
在 API 中回傳餐點計畫內容的方式
您可以回傳不同等級的餐點計畫,這也會對它們的意義產生重大影響。它們可以回傳為房價設施服務、旅宿設施服務或內容,在某些情況下亦可回傳為額外設施服務促銷。有關房價和旅宿設施服務的完整清單,請參閱「內容參考清單」。
房價計畫設施服務
**請注意:**內容回應中也可以看到房價設施服務。但是,如要查看有關房價設施服務的最新資訊,合作夥伴應該從購物回應而非內容回應中,取得餐點內容和其他房價設施服務。
在「內容參考清單」中,這些項目是列在 amenities_rates
下。
一些常見項目包括:
- 1073742786 - 免費早餐
- 2194 - 雙人早餐
- 2205 - 吃到飽早餐
- 2206 - 一泊二食
- 2111 - 全包
房價計畫設施服務可以在 Rapid 供應情況回應中查看。除非有指定數目,例如「雙人早餐」,否則預訂中所有旅客的房價均應包含餐點。
"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「Free breakfast」旅宿設施服務的意思,是指旅宿的所有客房及房價計畫均包含免費早餐。這個資料複寫到 Rapid 購物回應的房價層級時,會顯示為屬性 1073742786「Free Breakfast」。請注意,房價計畫設施服務會顯示房價計畫所包含的項目,而旅宿設施則會顯示該旅宿可供應但不一定為免費的項目,例如屬性 361 Breakfast available (surcharge)。
全包
旅宿的房價計畫可能部分或全數為全包。這些詳細資料會列在 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 不會出售旅宿名稱中帶有「全包」字樣的旅宿。此外,內容回應中的旅宿類別可能會顯示旅宿類別 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
}
}
},
特殊額外設施服務
隸屬於某個特別優惠的房價計畫,可能會在房價層級內容中加入有關優惠的其他資訊與限制。這會列在內容回應中回傳的任意文字欄位 special_offer_description
。
範例:
"201510380": {
"id": "201510380",
"amenities": {
"2191": {
"id": "2191",
"name": "Free high-speed internet"
},
"2194": {
"id": "2194",
"name": "Breakfast for 2"
},
"2109": {
"id": "2109",
"name": "Free self parking"
},
"2192": {
"id": "2192",
"name": "Free WiFi"
}
},
"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>"
},