餐點計畫內容

詳細了解在 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>"
          },
這個頁面有幫助嗎?
我們能如何改善內容?
感謝您協助我們進行改善!