食事プランの内容
API で食事プランの内容がどのように返されるかについて理解を深めます。
API で食事プランの内容が返される仕組み
食事プランはさまざまなレベルで返される可能性があり、これはその意味に重要な影響を与えます。これらは、料金アメニティ、宿泊施設アメニティ、コンテンツ、場合によっては宿泊特典付きプロモーションとして返されます。料金アメニティと宿泊施設アメニティの完全なリストについては、「コンテンツ リファレンス リスト」を参照してください。
料金プランアメニティ
注 : 料金アメニティはコンテンツ応答にも表示される場合があります。ただし、料金アメニティに関する最新情報については、パートナーはコンテンツ応答ではなくショップ応答から食事の内容やその他の料金アメニティを取得する必要があります。
「コンテンツ リファレンス リスト」では amenities_rates の下に一覧されています。
一般的なものとして次のようなものがあります。
- 1073742786 - 朝食 (無料)
- 2194 - 2 名分の朝食
- 2205 - 朝食ビュッフェ
- 2206 - 2 食付き
- 2111 - オールインクルーシブ
料金プランのアメニティは、ラピッド・アベイラビリティ・レスポンスでご確認いただけます。お食事は、特にご指示がない限り、ご予約のお客様全員に含まれています。アメニティ名（例：「2名様分の朝食」）、ルームタイプ名、ホテルの説明、または料金の説明で指示を返すことができます。詳細については、以下の特別付加価値 セクションをご参照ください。
"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）施設アメニティとは、施設のすべての客室と料金プランに無料の朝食が含まれていることを意味します。これは、属性 1073742786 の「無料の朝食」として Rapid のショップ応答の料金レベルで複製されます。
注: 料金プランに含まれるものを示す料金プランのアメニティとは異なり、施設のアメニティは施設で利用できるものを示し、必ずしも無料とは限りません。E.g. 属性361「朝食あり（有料）」。
オールインクルーシブ
宿泊施設では、一部またはすべての料金プランがオールインクルーシブである場合があります。これらの詳細は、Rapid のコンテンツ応答の all_inclusive セクションにあります。
すべての料金プランがオールインクルーシブ
all_rate_plans: 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すべての料金プランがその施設に対してall-inclusive、施設の名称に「オールインクルーシブ」が含まれていない限り、施設は販売しません。また、コンテンツ応答の宿泊施設カテゴリに宿泊施設カテゴリ 8「オールインクルーシブ宿泊施設」が存在する場合があります。施設カテゴリーの全リストをご覧ください。
一部の料金プランがオールインクルーシブ
some_rate_plans: 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
}
}
},特別な宿泊特典
特別オファーの一部である料金プランには、オファーに関する追加情報や制限を含むrate-levelおよびproperty-levelのコンテンツが含まれる場合があります。これらはContentレスポンスで返されるフリーテキストフィールドrates.special_offer_description、checkin.special_instructions、policies.know_before_you_go にリストされます。
付加価値に適用される可能性のある政策はいろいろあります。いくつか例を挙げましょう：
- 一部のお客様には、実際のご旅行者数、ご旅行者の年齢、またはbed-sharingの設定に基づき、e.g. 追加料金をお支払いいただきます。
- フリーミール料金プランにはお飲み物は含まれておりません。
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>"
}
}
}
}