就餐计划包含情况

详细了解 API 中如何返回就餐计划包含情况。

API 中如何返回就餐计划包含情况

就餐计划可在不同的级别返回,这对就餐计划含义的影响很大。就餐计划可作为房价服务/设施、住宿服务/设施、内容进行返回,在某些情况下还可作为增值促销项目进行返回。如需查看房价和住宿服务设施的完整列表,请参阅内容参考列表

房价计划服务设施

注意:在内容响应中可能也会看到房价服务设施。不过,要了解房价包含的服务/设施的最新信息,合作伙伴应从选购响应(而非内容响应)中了解房价中的就餐及其他服务设施包含情况。

在[内容参考列表] (products/rapid/lodging/content/content-reference-lists) 中,这些信息位于 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"
                ],

住宿服务设施

在[内容参考列表] (products/rapid/lodging/content/content-reference-lists) 中,这些信息位于 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“免费早餐”进行复制。请注意,房价计划服务设施显示的是包含在房价计划中的项目,住宿服务设施显示的则是住宿供应但不一定免费的服务设施,例如属性 361“提供早餐(收费)”。

全包

住宿的房价计划可能部分或全部为全包房价计划。此类详细信息位于 Rapid 内容响应的 all_inclusive 部分。

所有房价计划均为全包

如果 all_rate_plans: true 为 true,则相应住宿的所有房价计划均为全包,即使没有“全包”房价计划服务设施。

"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为 true,全包房价计划将具有房价计划服务设施 2111“全包”。酒店名称不会带有“全包”,住宿类别也不会是“全包式住宿”。

全包的限制条件

可在 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>"
          },
您觉得这个页面有用吗?
我们该如何改进这些内容?
感谢您帮助我们改进!