変更ログ
以下は、Rapid API で行われたすべての変更をリリース月ごとにグループ分けしてリスト化したものです。
2024 年 7 月
予約の領収書 - Manage Booking
| Feature
| V3
パートナーは、旅程取得レスポンスのリンクを使用して、Rapid API の新しいエンドポイントから予約の領収書を取得できるようになりました。詳細については、「予約の領収書」をご覧ください。
Rapid 3 の予約の領収書リクエストサンプル :
curl -X GET "https://test.ean.com/v3/itineraries/8999989898988/invoice\
?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"\
-H "accept: application/pdf"\
-H "customer-ip: 1.2.3.4"\
-H "accept-encoding: gzip"\
-H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
-H "user-agent: TravelNow/3.30.112"
Rapid 3 のレスポンスサンプル :
このレスポンスは、旅行者と共有できる、取引に関する領収書の PDF 表現です。
メリット :
パートナーは、出張経費を雇用主に報告する必要がある企業の旅行者向けに予約の領収書を発行する使いやすい API を利用できるようになりました。
2024 年 6 月
新しい検索と絞り込みのオプション - Content
| Feature
| V3
以下のフィールドで検索結果を絞り込める、新しいリクエストパラメーターを追加しました。
trip_reason
さらに、リクエストした言語でない口コミを削除できるようになる、フィルタパラメーターをリクエストに追加しました。
Rapid 3 リクエストの例 : この例では、新しい filter
パラメーターで language
の値を、新しい trip_reason
パラメーターで business
と business_and_leisure
の値を使用しています。
curl -X GET "https://test.ean.com/v3/properties/12345/guest-reviews\
?language=en-US\
&filter=language\
&trip_reason=business\
&trip_reason=business_and_leisure" \
-H "accept: application/json, application/json"\
-H "accept-encoding: gzip"\
-H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1719329586"\
-H "user-agent: TravelNow/3.30.112"
Rapid 3 レスポンスの例 : このレスポンスでは、新しい stay_date
と management_responses
フィールドが存在し、business
と business_and_leisure
の trip_reason
の値がある口コミのみが返されていることがわかります。
{
"verified": {
"recent": [
{
...
"stay_date": "2019-02",
"trip_reason": "business",
...
},
{
...
"stay_date": "2019-01",
"trip_reason": "business_and_leisure",
...
"management_responses": [
{
"text": "Dear Guest, Thank you for your feedback. I hope we have the opportunity to welcome you back in the near future. Best regards, Kara (General Manager)",
"date": "2019-02-11T14:36:54Z"
}
]
}
]
}
}
メリット :
レスポンスで返される追加のフィールドは、さらにお客様の状況などの情報を提供して、それらの口コミの価値を高めます。 口コミの検索結果を絞り込みたい場合、口コミを 1 つの言語と旅行理由に限定することができ、お客様満足度を高められます。
2024 年 4 月
ロイヤルティ - Book
| Shop
| Feature
| V3
宿泊施設ロイヤルティ獲得の機会が関連付けられているビジネスレートを見つけやすくする新機能を追加しています。ホテルロイヤルティポイントの詳細についてはこちらを参照してください。
メリット :
ビジネス旅行者が宿泊施設のロイヤルティプログラムでポイントを獲得しやすくなる、より優れたツールがパートナーに提供されます。
2024 年 1 月
マーケティング手数料 - Shop
| Feature
| V3
Shop リクエストの include
パラメーターに新しい値を追加しました。これにより、レスポンスで marketing_fee_incentives
オブジェクトが返されるようになります。
Rapid 3 のリクエストサンプル :
curl -X GET "https://test.ean.com/v3/properties/availability\
?checkin=2024-01-01\
&checkout=2024-01-03\
¤cy=USD\
&country_code=US\
&language=en-US\
&occupancy=2\
&property_id=19248\
&rate_plan_count=1\
&sales_channel=website\
&sales_environment=hotel_only\
&include=rooms.rates.marketing_fee_incentives\
&travel_purpose=leisure" \
-H "accept: application/json, application/json"\
-H "accept-encoding: gzip"\
-H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
-H "user-agent: TravelNow/3.30.112"
Rapid 3 のレスポンスサンプル :
[
{
"property_id": "19248",
"status": "available",
"rooms": [
{
"id": "123abc",
"room_name": "Fancy Queen Room",
"rates": [
{
"id": "333abc",
"status": "available",
...
"marketing_fee_incentives": [
{
"source": "property",
"start": "2024-01-01",
"end": "2024-01-01"
}
],
...
}
]
}
],
"links": { ... },
"score": 10052
}
]
メリット :
パートナー様は、特別なインセンティブが適用された料金をさらに簡単に特定できるようになります。
2023 年 11 月
新しい検索と絞り込みのオプション - Content
| Feature
| V3
以下のフィールドで検索結果を絞り込める、新しいリクエストパラメーターを追加しました。
all_inclusive
amenity_id
attribute_id
category_id
spoken_language_id
さらに、include
パラメーターの有効な値の数を増やすことで、レスポンスのどの部分を含めるかをより細かく指定できるようになりました。新しい値にはコンテンツレスポンスのすべての最上位要素が含まれます。詳細については、「検索と絞り込み」を参照してください。
Rapid 3 リクエストの例 : この例では、新しい amenity_id
検索パラメーターを使用しており、include
パラメーターで name
と amenities
の新しい値を使用しています。
curl -X GET "https://test.ean.com/v3/properties/content\
?language=en-US\
&supply_source=expedia\
&amenity_id=115\
&include=name\
&include=amenities\
&property_id=1337\
&property_id=1" \
-H "accept: application/json, application/json"\
-H "accept-encoding: gzip"\
-H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
-H "user-agent: TravelNow/3.30.112"
Rapid 3 レスポンスの例 : このレスポンスでは、宿泊施設 1 には設備 / サービス ID 115 がないため、宿泊施設 1337 のみが返されていることがわかります。property_id
、name
、amenities
がレスポンスに含まれていることもわかります。property_id
は常にレスポンスに含まれ、これがレスポンスで希望する唯一のフィールドでない限り、include
リクエストパラメーターとして指定する必要はありません。
{
"1337": {
"property_id": "1337",
"name": "Hyatt Regency Paris Etoile",
"amenities": {
"8": {
"id": "8",
"name": "Elevator"
},
"43": {
"id": "43",
"name": "Concierge services"
},
"115": {
"id": "115",
"name": "Bicycle rentals nearby"
},
"361": {
"id": "361",
"name": "Breakfast available (surcharge)"
},
...
}
}
}
メリット :
より具体的な宿泊施設とより具体的なレスポンスフィールドを求めているパートナー様が、Rapid Content API とのインタラクションを最適化できるようになりました。コンテンツのどの部分が必要かを指定することで、どのコンテンツが使用され、パートナー様にとって価値があるかを Rapid チームに伝えることもできます。
モバイル限定プロモーション販売のシナリオ - Shop
| Feature
| V3
変更リクエスト用に、値 sale_scenario.mobile_promotion
を空室状況とショップの include
パラメーターに追加しました。
変更レスポンス用に、room.rate.sale_scenario.mobile_promotion
フィールドを空室状況、追加料金、ショップに追加しました。
Rapid 3 のリクエストサンプル :
curl -X GET "https://test.ean.com/v3/properties/availability\
?checkin=2024-01-01\
&checkout=2024-01-03\
¤cy=USD\
&country_code=US\
&language=en-US\
&occupancy=2\
&property_id=19248\
&rate_plan_count=1\
&sales_channel=mobile_app\
&sales_environment=hotel_only\
&include=sale_scenario.mobile_promotion\
&travel_purpose=leisure" \
-H "accept: application/json, application/json"\
-H "accept-encoding: gzip"\
-H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
-H "user-agent: TravelNow/3.30.112"
Rapid 3 のレスポンスサンプル :
[
{
"property_id": "19248",
"status": "available",
"rooms": [
{
"id": "123abc",
"room_name": "Fancy Queen Room",
"rates": [
{
"id": "333abc",
"status": "available",
...
"sale_scenario": {
"package": false,
"member": false,
"corporate": false,
"distribution": false,
"mobile_promotion": false
},
...
}
]
}
],
"links": { ... },
"score": 10052
}
]
メリット :
どの料金にモバイル限定プロモーション料金プランが適用されるかをより簡単に確認したいパートナー様は、新たな方法でこれを実現できるようになります。
新しいバス停の地域タイプ - Geography
| Feature
| V3
Regions エンドポイントのリクエストに bus_station
地域タイプを追加しました。Region と Regions の両方が bus_station
タイプの地域に関するデータを提供するようになります。
Rapid 3 のリクエストサンプル :
curl -X GET "https://test.ean.com/v3/regions\
?include=standard\
&language=en-US\
&supply_source=expedia\
&type=bus_station" \
-H "Accept: application/json" \
-H "Authorization: EAN apikey=1234,signature=14140287ea6ea1396b18b,timestamp=1697826383" \
-H "Accept: application/json" \
-H "Accept-Encoding: gzip" \
-H "User-Agent: TravelNow/3.30.112"
Rapid 3 のレスポンスサンプル :
[
{
"id": "11234754",
"type": "bus_station",
"name": "Port Authority Bus Terminal",
"name_full": "Port Authority Bus Terminal",
"country_code": "US"
}
]
メリット :
パートナーは、旅行者向けのバス停情報を自社サイトに含めることができます。
2023 年 10 月
コンテンツ内のバケーションレンタル IPM 名 - Content
| Feature
| V3
宿泊施設コンテンツレスポンスに vacation_rental_details.ipm_name
フィールドを追加しました。
Rapid 3 のレスポンスサンプル :
{
"4687248": {
"property_id": "4687248",
"name": "Beautiful 6 Bedroom Home With Two Pools, Only 10 minutes To Theme Park!",
"address": { ... },
...
"fees": {
"traveler_service": "Your credit card statement will show two separate charges, one for the booking amount and property fees and another for the service fee. Both will be charged by Expedia partner Good Company.. The traveler service fee is refundable only when your entire booking is fully refundable. Please refer to the terms and conditions for the rules applicable to the booking facilitation services provided."
},
"attributes": { ... },
...
"vacation_rental_details": {
"private_host": true,
...
"vrbo_srp_id": "334.3634257.3458973",
"listing_id": "1252577",
"listing_number": "3834275",
"listing_source": "VRBO",
"listing_unit": "/units/0001/429ecad2-bade-429a-a427-8adee57420ec",
"ipm_name": "Good Company",
"unit_configurations": { ... },
"enhanced_house_rules": { ... },
"free_text": "Stunning brand new 2-story home with 6 bedrooms, 4 bathrooms, brand new appliances/furniture, game room, grill, patio, and beautiful scenery all around. Minutes from Super Cool Lake. This place is the perfect getaway for a larger group whether it be a golf trip, lake trip, or time to gather with the family. Please note this property has two parking stalls, in addition to first come first serve overflow parking in the community. Celebrating something special? Birthday, Anniversary, Bachelor/Bachelorette, etc? We also offer decorating services for an extra fee. Please inquire within! This home features a fully-equipped kitchen for preparing meals, onsite washer and dryer and most importantly a private space, much larger than a hotel room for private family time away from crowds and people. We have a self-check-in and check-out system to limit your contact with people as well. THE BASICS: 6 bedrooms & 1 loft - 5 Kings, 2 Bunk beds , and 1 pull-out couch in the loft - Sleeps 16 people. 4 Bathrooms - Master (jetted tub, walk-in shower, double sinks), other 3 bathrooms (tub/shower combo & sink). Fully Equipped Kitchen. Open Main Room with plenty of seating. Dining Room table and bar stools around kitchen island area. Plenty of space to spread out and enjoy your friends/family. Free Wifi. THE EXPERIENCE IN DETAIL: -As you walk in the front door and are greeted by the open floor layout of our kitchen and great room you immediately breathe easy seeing that there is plenty of room here for you and your family. Our Kitchen is stocked with plenty of cookware and dishes so you can create a huge breakfast that will get everyone out of bed and ready for a day of fun. A potted coffee maker and a Keurig is available. You will need to bring your own coffee/pods/filters/creamer etc. Cozy up in the living room for a late night movie on our large flat-screen TV equipped for your viewing pleasure. Our luxury Master bedroom with it’s King size bed, premium bedding, and TV invite you and your spouse to relax together and feel a little spoiled. This is a vacation after all! Enjoy our Master Bath with it’s jetted tub, walk-in shower, and double sinks. Explore the Upstairs which has 4 Bedrooms - 3 furnished with a King size bed, premium bedding, 1 is the bunk room which is equipped with 4 twin size beds. This home is not handicapped accessible!!!"
},
"supply_source": "Vrbo",
"spoken_languages": { ... }
}
}
メリット :
Vrbo 施設を販売するパートナーは、カードに請求したり確認メールを送信したりする IPM の名前を通知するゲスト メッセージングを構築するために IPM 名を必要とします。現在、この情報は段落形式の fees.traveler_service
コンテンツの一部としてのみ利用可能です。
Retrieve のマーケティング手数料 - Manage Booking
| Feature
| V3
取得レスポンスに room.rate.pricing.totals.marketing_fee
の取得時の推定値を追加しました。
Rapid 3 のレスポンスサンプル :
{
"itinerary_id": "8999989898988",
"property_id": "8150374",
...
"rooms": [
{
"id": "926784314",
"confirmation_id": { ... },
...
"status": "booked",
...
"rate": {
"id": "035943984",
"merchant_of_record": "expedia",
...
"pricing": {
"nightly": [ ... ],
"stay": [ ... ],
"totals": {
"inclusive": { ... },
"exclusive": { ... },
"marketing_fee": {
"billable_currency": {
"value": "7.75",
"currency": "USD"
}
},
"property_fees": { ... }
},
"fees": { ... }
}
},
"links": { ... }
}
],
"billing_contact": { ... },
...
}
メリット :
パートナーは、予約に大幅な変更が加えられた後、marketing_fee
の更新された値を確認できるようになります。
2023 年 9 月
取得の旅行の目的 - Manage Booking
| Feature
| V3
travel_purpose
の格納値を取得応答に追加しました。
Rapid 3 のレスポンスサンプル :
{
"itinerary_id": "8999989898988",
"property_id": "8150374",
...
"conversations": {...}
"travel_purpose": "leisure",
"trader_information": {...}
}
メリット :
旅行者がビジネス目的で旅行しているのか、それともレジャー目的で旅行しているのかについて宿泊施設に伝えた値をパートナー様が確認できるようになります。
2023 年 7 月
公開停止中の施設 - Content
| Feature
| V3
公開停止中の施設エンドポイントを追加しました。
Rapid 3 のリクエストサンプル :
https://test.ean.com/v3/properties/inactive?since=2023-07-12
Rapid 3 のレスポンスサンプル :
[
{
"property_id": "15316"
},
{
"property_id": "15362666"
},
{
"property_id": "15462554"
},
{
"property_id": "1614382"
},
{
"property_id": "18762476"
}
]
メリット :
パートナー様は、キャッシュされたコンテンツから施設を迅速かつ簡単に削除し、どの施設に対して空室状況リクエストが送信されなくなるかを把握できます。
旅行目的インジケーター - Shop
| Feature
| V3
空室状況リクエストに travel_purpose
パラメーターを追加しました。
Rapid 3 のリクエストサンプル :
空室状況リクエストの新しいパラメーター :
travel_purpose=business
メリット :
旅行者がビジネス目的で旅行しているのか、それともレジャー目的で旅行しているのかをパートナー様が伝えることができるようになります。
利用不可理由 - Shop
| Feature
| V3
料金が返金されないことに関して正当な理由がない宿泊施設のエントリをレスポンスに含めることをリクエストする、値が unavailable_reason
の空室状況リクエストに include
パラメーターを追加しました。
Rapid 3 のリクエストサンプル :
空室状況リクエストの新しいパラメーター :
include=unavailable_reason
メリット :
ショッピング結果の一部として、宿泊施設に空室がない理由に関する情報をパートナー様が含めることができるようになります。
設備 / サービスカテゴリ検索 - Shop
| Feature
| V3
空室状況リクエストに amenity_category
パラメーターを追加しました。
Rapid 3 のリクエストサンプル :
空室状況リクエストの新しいパラメーター :
amenity_category=wifi
メリット :
カテゴリが一致する設備やサービスを含む料金をパートナー様が検索できるようになります。
インクルーシブの取り消し線 - Shop
| Feature
| V3
inclusive_strikethrough
の価格情報を追加しました。
Rapid 3 のレスポンスサンプル :
[
{
"property_id": "19248",
"rooms": [
{
"id": "123abc",
"room_name": "Fancy Queen Room",
"rates": [
{
"id": "333abc",
...
"occupancy_pricing": {
"2": {
"nightly": [ ... ],
"stay": [ ... ],
"totals": {
"inclusive": { ... },
"exclusive": { ... },
"inclusive_strikethrough": {
"billable_currency": {
"value": "726.63",
"currency": "CAD"
},
"request_currency": {
"value": "549.60",
"currency": "USD"
}
},
"strikethrough": { ... },
"marketing_fee": { ... },
"gross_profit": { ... },
"minimum_selling_price": { ... },
"property_fees": { ... }
},
"fees": { ... }
}
}
}
]
}
]
}
]
メリット :
税金と手数料も対象になる、ホテルが資金を提供する割引により、パートナー様が節約した分をプロモーションに利用できるようになります。
2023 年 6 月
大幅な変更 - Book
| Feature
| V3
新しい大幅な変更のエンドポイントとフローを Rapid に追加しました。
メリット
パートナー様は、お客様に代わって Rapid API を通じて予約を変更できるようになりました。
詳細については「大幅な変更」をご覧ください。
旅程履歴 - Book
| Feature
| V3
旅程履歴情報を Itinerary Search と Itinerary Retrieve の呼び出しに追加しました。
メリット
パートナー様は、 Itinerary Search または Itinerary Retrieve の一環として、作成、大幅な変更、キャンセルに関連する旅程履歴の詳細を取得できるようになりました。
詳細については「旅程履歴」をご覧ください。
2023 年 4 月
VRBO オーナー自由形式テキストの説明 - Content
| Feature
| V3
宿泊施設コンテンツレスポンスの vacation_rental_details
セクションに free_text
を追加しました。
Rapid 3 スキーマの例 :
{
"12345": {
"property_id": "12345",
"name": "Test Property Name",
"phone": "1-417-862-0153",
"vacation_rental_details": {
"free_text": "Free form description and explanation of property provided by the host.Can possibly contain html break tags.",
"listing_id": "1237874"
}
}
}
注 : 例ではコンテンツ応答のすべての施設が表されているわけではありません。
メリット
オーナーから提供されたバケーションレンタル施設について、パートナーはより詳しい情報を提示できるようになります。
「迅速な統合ガイドの Vrbo」を参照してください。
地域検索の強化 - Geography
| Feature
| V3
いくつかの新しい検索パラメーターが追加されました。
area
半径、および座標 (緯度 / 経度のペア) と地域 ID のいずれかを使用してエリアを定義します。limit
返される結果の件数を制限します。country_subdivision_code
ISO 3166-2 国下位区分コードに一致する結果を返します。
country_subdivision_code
を Regions
と Region
の応答に追加
メリット
パートナーは、指定したエリアと交差する地域を選択できるようになります。
緯度 / 経度の 50 km 以内の空港の検索 :
type=airport&limit=3&area=50,37.227924,93.310036
OpenAPI 仕様の改善 - Update
| V3
OpenAPI 仕様に複数の異なる改善を加えています。
- API Explorer で正しく表現されるように、日付は引用符で囲まれています。
- Java クライアントが生成するコードとの互換性を高めるため、BoundingPolygon を再度調整しました。
- ISO 標準を参照する際の一貫性を向上させました (例 : ISO 639-1 alpha-2 と ISO 3166-1 alpha-2)。
この変更は OpenAPI 仕様を改善するためだけのものであり、API の機能には影響を与えません。
メリット
API Explorer の機能を強化し、ダウンロードした OpenAPI 仕様の yaml ファイルを使用するパートナーの互換性を向上させました。
2023 年 1 月
返金可能な損害補償デポジット料金の除外 - Shop
| Feature
| V3
空室状況リクエストに exclusion
パラメーターを追加しました。
Rapid 3 のリクエストサンプル :
Shop リクエストの新しいパラメーター :
exclusion=refundable_damage_deposit
メリット :
パートナーは、返金可能な損害補償デポジットがある料金を応答に含めないよう指定できます。
わかりやすくなったジオグラフィーポリゴンとサンプル - Geography
| Update
| V3
座標のリクエストと応答における Polygons の形式で、仕様に不正確な情報がありました。Geography エンドポイントの API Explorer で使用できるようにサンプルを更新しました。
この変更は OpenAPI 仕様を修正するためだけのものであり、API の機能には影響を与えません。
Rapid 3 スキーマの例 :
こちらは地域の応答から切り取った例です。
"coordinates": {
"center_longitude": -93.29277,
"center_latitude": 37.207935,
"bounding_polygon": {
"type": "Polygon",
"coordinates": [
[
[
-93.298931,
37.205162
],
[
-93.28672,
37.205299
],
[
-93.286549,
37.21005
],
[
-93.286763,
37.210221
],
[
-93.298931,
37.205162
]
]
]
}
},
メリット :
地域で応答にポリゴン (Polygon) とマルチポリゴン (MultiPolygon) 両方のオブジェクトを返すことができることが仕様に正確に反映されるようになりました。また、ポリゴン検索の正確なスキーマと例も用意されています。
2022 年 12 月
Vrbo 空室状況カレンダー - Shop
| Feature
| V3
Vrbo 空室状況カレンダーエンドポイント「/calendars/availability」を追加。
Rapid 3 スキーマの例 :
[
{
"property_id": "1234",
"days": [
{
"date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
"available": true,
"checkin": "CHECKIN_VALID",
"checkout": "CHECKOUT_VALID",
"stay_constraints": {
"min_stay": 1,
"max_stay": 14
}
},
{
"date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
"available": true,
"checkin": "CHECKIN_VALID",
"checkout": "CHECKOUT_VALID",
"stay_constraints": {
"min_stay": 1,
"max_stay": 14
}
}
]
}
]
メリット :
Rapid Availability Calendar API では、特定の施設の空室状況について、一定期間にわたる日々の概要を提供できます。この情報は、お客様が施設の詳細ページを閲覧する際に役立ちます。
詳細については、こちらをご覧ください。
強化されたハウスルールの充実 - Content
| Feature
| V3
Vrbo 宿泊施設用の Rapid Content API に、ハウスルールの後継となる強化されたハウスルールが追加されました。
Rapid 3 スキーマの例 :
"enhanced_house_rules": {
"CheckIn": {
"rule": "Check in after 3:00 PM",
"additional_information": []
},
"CheckOut": {
"rule": "Check out before 11:00 AM",
"additional_information": []
},
"Occupancy": {
"rule": "Maximum overnight guests: 5 (sleeps up to 5 adults)",
"additional_information": []
},
"MinBookingAge": {
"rule": "Minimum age to rent: 18",
"additional_information": []
},
"Children": {
"rule": "Children allowed: ages 0-17",
"additional_information": []
},
"Pets": {
"rule": "Pets allowed: 1 pet less than 10kgs",
"additional_information": [
"Pets allowed under aproval/Se requiere aprobacion"
]
},
"Events": {
"rule": "No Events allowed",
"additional_information": []
},
"Smoking": {
"rule": "Smoking allowed: outside",
"additional_information": [
"Silence is required after 10pm/Silencio 10pm",
"At the balcony, Thank you! En el balcon, Gracias!"
]
}
}
メリット :
強化されたハウスルールにより、各ポリシーの制限 / 例外やお客様の滞在に関連するその他の情報を説明する、オーナーによる自由入力形式のメモなどで、宿泊施設のポリシーをよりわかりやすく表示できるようになります。
Geography の強化 - Geography
| Feature
| V3
Geography の呼び出しが以下のように強化されました。
- Polygon リクエスト内の Region、Regions、Properties に
supply_source
フィルタリングを追加しました。 - Polygon 応答内の Region、Regions、Properties に
Pagination-Total-Results
ヘッダーを追加しました。 - Regions リクエストに
type
とcountry_code
のフィルタリングを追加しました。
メリット :
さまざまな Geography 呼び出しのこのような強化により、パートナーは受け取る結果をよりきめ細かく制御できます。
2022 年 11 月
返金不可の日付範囲を追加 - Shop
| Manage Booking
Feature
| V3
空室状況と旅程の回答に返金不可の日付範囲オブジェクトを追加しました。
Rapid 3 スキーマの例 :
"nonrefundable_date_ranges": [
{
"start": "2022-09-05",
"end": "2022-09-11"
}
],
メリット :
サプライヤーが休日などの要因に基づいて設定した返金例外をパートナーが表示できるようになるため、キャンセル時に返金を受けられるタイミングについてお客様に適切に情報を伝達できます。
Region 応答にカテゴリリストとタグリストを追加 - Geography
| Feature
| V3
すべての Region 応答にカテゴリリストとタグリストを追加しました。
Rapid 3 スキーマの例 :
"categories": [
"tourism:region"
],
"tags": [
"geoAdmin:city"
]
メリット :
パートナーはカテゴリとタグを活用して、返される地域のメタデータ情報を取得できるようになります。
Rapid バージョン 2.3 と 2.4 の廃止 - Remove
| V2.4
| Breaking Change
Rapid API のバージョン 2.3 と 2.4 は現在廃止されています。
2022 年 10 月
Content に Vrbo 用ユニット構成を追加 - Content
| Feature
| V3``
Content 応答にユニット構成オブジェクトを追加しました。
Rapid 3 スキーマの例 :
[
{
"property_id": "1234",
"days": [
{
"date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
"available": true,
"checkin": "CHECKIN_VALID",
"checkout": "CHECKOUT_VALID",
"stay_constraints": {
"min_stay": 1,
"max_stay": 14
}
},
{
"date": "Tue Dec 13 2022 09:20:31 GMT-0800 (PST)",
"available": true,
"checkin": "CHECKIN_VALID",
"checkout": "CHECKOUT_VALID",
"stay_constraints": {
"min_stay": 1,
"max_stay": 14
}
}
]
}
]
メリット :
ユニット構成は、客室にあるベッドタイプとそれぞれの数を表します。
2022 年 7 月
中国語 (香港) を追加 - Content
| Shopping
| Feature
| V3
中国語 (香港) 言語オプションが追加されました。言語パラメーターがサポートされているリクエストで、"zh-HK" 言語コードを使用できるようになりました。
サポートされているすべての言語のリストはこちらにあります。
Vrbo の滞在に関する重要情報 - Manage Booking
| Feature
| V3
旅程応答に Vrbo の滞在に関する重要情報を追加しました。
Rapid 3 スキーマの例 :
"essential_information": {
"contact": {
"name": "John test",
"phone": {
"country_code": "1",
"area_code": "367",
"phone_number": "6876876"
},
"email": "dv@devmail.wvrgroup.internal",
"address": {
"line_1": "3rd St",
"line_2": "421 W",
"city": "Austin",
"state_province_code": "TX",
"postal_code": "86868",
"country_code": "US"
}
},
"essentials": [
{
"name": "directions",
"instructions": "30.3079827,-97.8934852\n\nTurn right into the alley at the end of the road.",
"images": [
{
"url": "https://odis-stage.vrbo.com/odis/hospitality/a94d96e2-499b-4155-8872-6d0a4dd9a9db.large.jpg",
"width": 1024,
"height": 768
},
{
"url": "https://odis-stage.vrbo.com/odis/hospitality/e1713ff4-ad67-4498-93a1-befbdf5275a0.large.jpg",
"width": 1024,
"height": 768
}
]
},
{
"name": "wifi",
"instructions": "Secure, hi speed wifi is available throughout the property.",
"images": [
{
"url": "https://odis-stage.vrbo.com/odis/hospitality/caa47f61-3e7f-459b-bd74-e3cfe76a0edc.large.jpg",
"width": 1024,
"height": 768
}
],
"additional_info": {
"network_name": "HomeNetwork",
"network_password": "HomeNetwork1234567890"
}
},
{
"name": "thermostat",
"instructions": "Thermostat\n\nDo not adjust thermostat below 59F/15C."
}
],
"updates_available_datetime": "2022-08-14T09:00:00-05:00"
}
メリット :
Vrbo の滞在に関する重要事項では、宿泊施設の住所や施設管理者の連絡先情報など、到着前の重要な指示事項をお客様に提供します。また、お客様にとって到着時、滞在中、または出発時に必要になる可能性があるその他の重要な詳細を含めることもできます。
2022 年 5 月
すべてのバージョンにおける消費者のためのニューディール (ND4C) 規制の変更 - Shopping
| Booking
| Manage Booking
| Feature
| V3
| Breaking Change
「消費者のためのニューディール」(ND4C) 規制がビジネスに与える影響に対応できるよう、Rapid が更新されています。この法律は、欧州連合および英国の販売サイトに影響を与えます。
Rapid 3 スキーマの例 :
"trader_information": {
"traders":[
{
"name": "Expedia",
"address": {
"line_1": "555 1st St",
"line_2": "10th Floor",
"line_3": "Unit 12",
"city": "Seattle",
"state_province_code": "WA",
"postal_code": "98121",
"country_code": "US"
},
"email": "travel@support.expedia.com",
"phone": "0330-123-1235",
"contact_message": "This property is managed by a professional host. The provision of housing is linked to trade, business or profession."
}
],
"terms_and_conditions": "https://www.expedia.com/terms_and_conditions"
}
メリット :
ND4C の規制要件に準拠するため、パートナーにトレーダー情報を提供します。
クロアチア語とリトアニア語を廃止 - Content
| Shopping
| Remove
| V3
クロアチア語とリトアニア語が廃止されました。言語パラメーターを受け付けるリクエストにこれらの言語を渡そうとするとエラーになります。
2022 年 4 月
Rapid バージョン 2.3 と 2.4 を非推奨に - Deprecated
| V2.4
| Breaking Change
Rapid API のバージョン 2.3 と 2.4 は現在非推奨となっています。両バージョンとも 2022 年 10 月に廃止される予定です。
Rapid バージョン 2.2 の廃止 - Remove
| V2.2
| Breaking Change
Rapid API のバージョン 2.2 は現在廃止されています。
2021 年 9 月
Notifications Test API にリクエスト本文を追加 - Notifications
| Change
| V3
| Breaking Change
リクエスト本文が必須になりました。
Rapid 3 スキーマの例 :
{
"event_type": "itinerary.agent.create"
}
メリット :
Rapid API 全体で一貫性が維持されます。
Notifications Undeliverable API に undeliverable パラメーターを追加 - Notifications
| Change
| V3
| Breaking Change
新しいクエリパラメーター undeliverable が必須になりました。
メリット :
Rapid API 全体で一貫性が維持されます。
Shop との一貫性を保つため、Refundable Damage Deposit フィールドと Card On File Limit フィールドを移動 - Manage Booking
| Change
| V3
| Breaking Change
Shop との一貫性を保つため、Refundable Damage Deposit フィールドと Card On File Limit フィールドを移動しました。
Rapid 3 スキーマの例 :
"card_on_file_limit": {
"value": "string",
"currency": "string"
},
"refundable_damage_deposit": {
"value": "string",
"currency": "string"
},
メリット :
これにより、パートナーのスキーマが簡素化されます。
Notifications API エンドポイントの変更 - Notifications
| Change
| V3
| Breaking Change
Notifications Test API と Notifications Undeliverable API のエンドポイントが変更されました (末尾の /{event_type}
と /undeliverable
を削除)。Notifications Test API のエンドポイントが GET から POST に変更されました。
メリット :
Rapid API 全体で一貫性が維持されます。
Shop との一貫性を保つために Deposit Policy の名前を Deposits に変更 - Manage Booking
| Change
| V3
| Breaking Change
Shop との一貫性を保つために Deposit Policy オブジェクトの名前を Deposits に変更しました。
Rapid 2.4 スキーマの例 :
"deposit_policies": [
{
"amount": "220.75",
"due": "2018-12-12T01:01:01.000-08:00"
}
],
Rapid 3 スキーマの例 :
"deposits": [
{
"amount": "220.75",
"due": "2018-12-12T01:01:01.000-08:00"
}
],
メリット :
これにより、パートナーのスキーマが簡素化されます。
TripAdvisor Content API エンドポイントを廃止 - Content
| Deprecate
| V3
| Breaking Change
Expedia Group とトリップアドバイザーの提携関係は解消されているため、Rapid 3 では TripAdvisor Content API エンドポイントが廃止されます。
メリット :
パートナーは冗長エンドポイントを呼び出すことができなくなります。
ロイヤルティ ID を追加 - Booking
| Manage Booking
| Feature
| V3
| Breaking Change
パートナーがホテルのロイヤルティ ID を提供できるようにする新機能
- この客室のお客様に関連付けられているホテルロイヤルティプログラムの識別子。
- 客室オブジェクトの下に存在
Rapid 3 スキーマの例 :
"rooms": [
{
"given_name": "John",
"family_name": "Smith",
"smoking": false,
"special_request": "Top floor or away from street please",
"loyalty_id": "ABC123"
}
],
注 : 新しいフィールドは複数の場所に配置されます
- 予約リクエストの作成
- 旅程の取得
- 旅程の変更
メリット :
パートナーがホテルのロイヤルティ ID を含めて、この情報をホテルに渡すことができるようになります。
*情報提供のみを目的としており、ホテルが追加のポイント、特典を提供することを保証するものではありません
Rapid 在庫応答への deposit データの追加 - Shopping
| Feature
| V3
Rapid 3 では、パートナーが deposit (支払いスケジュール) 情報のために別途電話をかける必要がなくなります。代わりに、このデータを Rate オブジェクトの子として表示します。
deposit (支払いスケジュール) データのために追加で電話をかける必要がなくなるとともに、priceCheck 応答でデータを利用できるようにして可視性を高めます。
Rapid 3 スキーマの例 :
"deposits": [
{
"value": "70.00",
"due": "2021-08-21",
"currency": "CAD"
}
]
Rapid 3 では、保証金データを取得するために保証金リンクを返す必要がなくなります。このデータは取得され、代わりに応答に表示されます。
Rapid 2.4 スキーマの例 :
"links": {
"payment_options": {
"method": "GET",
"href": "/2.4/properties/19248/payment-options?token=MY5S3j36cOcL"
},
"deposit_policies": {
"method": "GET",
"href": "/2.4/properties/19248/deposit-policies?token=MY5S3j36cOcL"
}
}
Rapid 3 スキーマの例 :
"links": {
"payment_options": {
"method": "GET",
"href": "/2.4/properties/19248/payment-options?token=MY5S3j36cOcL"
}
}
デポジットの新しい配列と重複するため、Rapid 3 が deposit_required フィールドを返さなくなります。
Rapid 2.4 スキーマの例 :
"sale_scenario": {
"package": false,
"member": true,
"corporate": false,
"distribution": false
},
"deposit_required": true,
"merchant_of_record": "expedia",
Rapid 3 スキーマの例 :
"sale_scenario": {
"package": false,
"member": true,
"corporate": false,
"distribution": false
},
"merchant_of_record": "expedia",
メリット :
パートナーは、データのために追加で電話をかける必要がなくなります。これは応答内に埋め込まれます。
priceCheck 応答で、バケーションレンタルの card_on_file_limit と fundamental_damage_deposit のサポートを追加 - Shopping
| Feature
| V3
バケーションレンタルに関連する新たなデータを追加しました。card_on_file_limit は、宿泊施設での損害に対してカードに請求できる最大額であり、refundable_damage_deposit は宿泊施設に必要な保証金額です。応答で使用できる値は 1 つだけです。特定の料金で両方を同時にパートナーに返すことはありません。
Rapid 3 スキーマの例 :
"card_on_file_limit": {
"value": "25.00",
"currency": "CAD"
},
"refundable_damage_deposit": {
"value": "75.00",
"currency": "CAD"
}
メリット :
パートナーは、バケーションレンタル宿泊施設の保証金と見込み額を完全に把握できます。
Property Content API / ファイルおよび宿泊施設カタログファイルに追加された必須の supply_source フィールド - Content
| Feature
| V3
| Breaking Change
Property Content API / ファイルおよび宿泊施設カタログファイルに必須の supply_source フィールドが新たに追加され、返却を希望する在庫のタイプをパートナーが指定できるようになりました。
値 'expedia' を渡すと、Expedia からの在庫のみが返されます。
値 'vrbo' を渡すと、Vrbo からの在庫のみが返されます。
Rapid 3 スキーマの例 :
"supply_source": "vrbo"
注 : supply_source が必須フィールドになりました。以前のバージョンの API と同じ動作を実現するには、パートナーが "supply_source": "expedia" を渡す必要があります。
メリット :
パートナーは、Expedia の在庫と同じエンドポイントを介して Vrbo の在庫にアクセスできるようになります。
Property Content API に新しいセクションを追加 / バケーションレンタル専用の宿泊施設と客室の情報に関するファイルを統合 - Content
| Feature
| V3
| Breaking Change
Rapid コンテンツ / ファイルにバケーションレンタル セクションが新規追加されました。パートナーはこのセクションで、複数ユニットの宿泊施設の客室の説明内にある属性を含む、バケーションレンタルに特化した施設情報を確認できます。
パートナーのチェックアウトページに宿泊予約における同意書を表示することが、バケーションレンタル宿泊施設における Rapid リリース要件になりました。
Rapid 3 スキーマの例 :
"vacation_rental_details": {
"property_registration":{
},
"private_host"{
},
"property_manager": {
"name": "Frans Belderbos",
"links": {
"image": {
"method": "GET",
"href": "https://odis.vrbo.com/odis/story/89cd116a-14fd-4fbc-a0d1-861894171cd0.c1.jpg"
}
},
"rental_agreement": {
"links": {
"rental_agreement": {
"method": "GET",
"href": "https://www.vrbo.com/td/proxies/ecomQuote/downloadRentalAgreement?unitUrl=/units/0000/1341f175-3550-4c80-b9a1-b6b330b7e032"
}
}
},
"house_rules": [
"Children welcome",
"Pets welcome (restrictions apply)",
"No smoking",
"No parties or events"
],
"amenities": {
"1073743284": {
"id": "1073743284",
"name": "Heating"
},
"4296": {
"id": "4296",
"name": "Furnished balcony or patio"
}
}
}
}
メリット :
コンテンツ応答のバケーションレンタル専用セクションで、単一ユニットのバケーションレンタルの宿泊施設表示を改善できる、より多くの宿泊施設情報を提供します。
PSD2 のサードパーティ認証 - Booking
| Feature
| V3
| Breaking Change
PSD2 準拠のためにパートナーが優先決済サービスプロバイダーを使用できるようにする新製品
cavv
、eci
、three_ds_version
、ds_transaction_id
の各パラメーターが必要です。
Rapid 3 スキーマの例 :
"third_party_authentication": {
"cavv": "jELUbgG+Tgj0AREBDMLeCad+oIs=",
"eci": "05",
"three_ds_version": "2.2.0",
"ds_transaction_id": "ac01cc2b-c1a1-4981-8c6f-400d4eec88de",
"pa_res_status": "Y",
"ve_res_status": "C",
"xid": "47133847-13be-4ae3-9be9-e4053b9c83c0",
"cavv_algorithm": "3",
"ucaf_indicator": "0"
}
メリット :
PSD2 準拠のためにパートナーが優先決済サービスプロバイダーを使用できるようになります
セキュリティバグを修正するために特殊文字エンコーディングを追加 - Booking
| Bug Fix
| V3
| Breaking Change
セキュリティの脆弱性を防ぐために、いくつかのフィールドの特殊文字が再エンコードされます。
メリット :
これにより、潜在的なセキュリティの脆弱性が解消されます。
Price Check テストヘッダーのバグを修正 - Shopping
| Bug Fix
| V3
Price Check 呼び出しの無効なテスト ヘッダーの名前が、有効な値に一致するように変更されました。
Rapid 2.4 スキーマの例 :
--header "Test: matched"
Rapid 3 スキーマの例 :
--header "Test: available"
メリット :
パートナーが Price Check との統合をより徹底的にテストできるようになります。
Customer_account_Details 列挙のタイプミスを修正 - Booking
| Bug Fix
| V3
| Breaking Change
customer_account_details 列挙のタイプミスを修正し、 "fido_authenticaton" を "fido_authentication" に変更しました。
Rapid 2.4 スキーマの例 :
"customer_account_details": {
"authentication_method": "fido_authenticaton",
"authentication_timestamp": "2018-02-12T11:59:00.000Z",
"create_date": "2018-09-15",
"change_date": "2018-09-17",
"password_change_date": "2018-09-17",
"add_card_attempts": 1,
"account_purchases": 1
},
Rapid 3 スキーマの例 :
"customer_account_details": {
"authentication_method": "fido_authentication",
"authentication_timestamp": "2018-02-12T11:59:00.000Z",
"create_date": "2018-09-15",
"change_date": "2018-09-17",
"password_change_date": "2018-09-17",
"add_card_attempts": 1,
"account_purchases": 1
},
メリット :
これにより、パートナーを混乱させるスペルミスがなくなります。
クロスセルと代替施設の推奨事項を削除 - Recommendations
| Remove
| V3
| Breaking Change
reference_property_id
、destination_iata_airport_code
、origin_iata_airport_code
および iata_airline_code
の各パラメーターが削除されました。推奨事項のリンクが応答に表示されなくなります。
Rapid 2.4 スキーマの例 :
"recommendations": {
"method": "GET",
"href": "/2.4/properties/availability?token=abcdef"
}
メリット :
パートナーは、冗長リクエストパラメーターを使用して呼び出すことができなくなります
Fees オブジェクトの廃止されたフィールドを削除 - Shopping
| Booking
| Manage Booking
| Remove
| V3
| Breaking Change
情報提供が目的で、料金合計の表示で混乱を招くフィールドを削除することで、Fees オブジェクトを簡素化しました。
Rapid 2.4 スキーマの例 :
"fees": {
"mandatory_fee": {
"billable_currency": {
"value": "5.00",
"currency": "CAD"
},
"request_currency": {
"value": "3.00",
"currency": "USD"
},
"scope": "per_person",
"frequency": "per_day"
}
}
Rapid 3 スキーマの例 :
"fees": {
"mandatory_fee": {
"billable_currency": {
"value": "5.00",
"currency": "CAD"
},
"request_currency": {
"value": "3.00",
"currency": "USD"
}
}
}
メリット :
請求料金を明確にするために、scope と frequency が削除されました。これにより、不要なフィールドが削除され、パートナーのスキーマが簡素化されます。
/properties/{property_id}/deposit-policies パスを削除 - Shopping
| Remove
| V3
在庫の呼び出しに直接含まれるようになったため、deposit-policies エンドポイントは削除されます。
メリット :
パートナーは、デポジットに関するルール情報を取得するために追加の呼び出しを行う必要がなくなります。
郵便番号の説明を明確化 - Booking
| Update
| V3
郵便番号フィールドの説明は、混乱を避けるために簡素化されました。
Rapid 2.4 スキーマの例 :
お客様の郵便番号。支払タイプがクレジットカード (CC、CCC、VCC) で、国コードが US、GB、または CA の場合、Postal_Code は必須です。
Rapid 3 スキーマの例 :
郵便番号。
メリット :
フィールドが必須の場合を明確にします。
料金プランカウントの説明を明確化 - Shopping
| Update
| V3
料金プランカウントの説明を明確化 : 料金プランカウントフィールドの説明が更新され、最小制限と最大制限が含まれるようになり、フィールドが返そうとしているもの (利用可能なベストプライス) が明確になりました。
Rapid 2.4 スキーマの例 :
宿泊施設ごとに返す料金の数。料金のレートによって、どのレートが返されるかが決まります。たとえば、rateplancount=4 の場合、最も低い 4 つのレートが返されますが、応答では低いレートから高いレート、またはその逆の順序で並べられることはありません。最も安い料金では最高のコンバージョン率が得られることが保証されているため、値を 1 にすることをお勧めします。値は 0 より大きくする必要があります。
Rapid 3 スキーマの例 :
宿泊施設ごとに返す料金の数。ベストプライスのレートが返されます。たとえば、rate_plan_count=4 の場合、ベストな 4 つのレートが返されますが、応答では低いレートから高いレート、またはその逆の順序で並べられることはありません。基本的に最低料金が優先されます。値は 1 から 250 の間でなければなりません。
メリット :
フィールドの有効な値を明確にします。
都道府県地域コードの説明を明確化 - Booking
| Update
| V3
都道府県地域コードフィールドの説明は、混乱を避けるために簡素化されました。
Rapid 2.4 スキーマの例 :
お客様の都道府県コードまたは地域コード。country_code = US、AU、または CA の場合は必須
Rapid 3 スキーマの例 :
オーストラリア、カナダ、アメリカに使用する 2 文字または 3 文字の州 / 地方コード。
メリット :
フィールドが必須の場合を明確にします。