Rapid Activities APIの概要

Rapid Activities APIを活用して、旅行者がアクティビティや体験を予約できるようにします

早期アクセスプレビュー

このドキュメントは、選定されたパートナーのみを対象とした早期アクセスプレビュー・イニシアチブの一環です。ベータ版プログラムは2026年第3四半期に開始され、2027年に一般提供が開始される予定です。

ベータパートナーになることにご興味をお持ちの方は、アカウントマネージャーまでご連絡ください。

Rapid Activities APIは、統合が容易なend-to-endのショッピングおよび予約フローを通じて、旅行者にアクティビティを効果的に紹介できるよう設計されています。これにより、旅行者にはより充実した体験を提供できると同時に、新たな収益源を開拓することが可能になります。

重要な概念

契約期間	定義
現地ツアー	予約可能なイベント（展示・販売する内容）。
アクティビティグループ	類似した活動のまとめです。
体験	複数のアクティビティを含む可能性のある、概念的・マーケティング的な枠組みです。
チケット	アクティビティの予約タイプ（大人／子供／幼児など）。
予約詳細	1つのアクティビティと、1枚以上のチケットを含む予約（アクティビティの予約）です。
カテゴリー	High-level体験やアクティビティをテーマごとに分類したグループ（例えば、市内観光、美術館、アウトドアアクティビティなど）。
属性	体験やアクティビティの具体的な特徴を表す説明用フラグ（例：車椅子対応、「家族連れに最適」、「ガイド付きツアー」、「優先入場」など）。

エンドツーエンドの統合フロー

このAPIを使用したアクティビティの予約は、以下の一般的な手順に従います。

ステップ1：在庫を確認する

まずは、販売準備が整った、目的地別の体系的なアクティビティカタログを作成することから始めましょう。このカタログをご覧いただければ、その地域で販売できる商品についてご理解いただけるでしょう。

カタログの設定

region-mappingエンドポイントを使用して、地理的地域を基盤となるインベントリ（体験、アクティビティ、およびアクティビティグループ）にマッピングします。注：今回のバージョンでは、Activities APIは「region_ID」パラメータのみをサポートします。

>> リージョンに関する詳細はこちら 2. 多言語の豊富なアクティビティコンテンツ（タイトル、説明、画像、場所、カテゴリ）を取得します。 3. アクティビティのゲスト評価やレビューを掲載し、旅行者が選択肢を比較し、その体験に対する信頼を築けるようにします。 4. 検索結果、アクティビティの詳細ページ、およびフィルター（例：「家族向け」や「ウォーキングツアー」など）に情報を表示します。

地域およびエリアで絞り込む

Rapid Activities APIでは、area クエリパラメータを使用して、region_id で定義されたゾーンとarea の座標で定義されたゾーンの共通領域内にあるディスカバリー対象を絞り込むことができます。これは、カスタムフィルタリングのロジックを簡素化し、ホテルなどの特定の地点の近くで行われる旅行者のアクティビティを表示できるようにするためのものです。

areaフィルターを使用するには、radius_km、latitude、およびlongitude の各フィールドをその中に含め、返したい活動の地理的範囲を指定してください。

リクエストの例

GET /v2/regions/{region_id}/activity-groups?area=10,34.0512226,-118.2403994&pagination_size=25

注： radius_km（area 内の最初のフィールド）は、0以上の整数でなければなりません。

ステップ2：空室状況と料金を検索する

アクティビティがいつ利用可能か、また料金はいくらかを確認しましょう。予約可能な日時、チケットの種類、価格帯を活用して、購入プロセスを促進しましょう。

具体的なアクティビティや日程につきましては、チケットの種類ごとに空き状況や料金をお問い合わせください。
購入者向け画面に、カレンダー（予約可能な日・予約不可の日）、時間帯、および最低価格を表示します。
1回の呼び出しで複数のアクティビティをサポートします。

ステップ3：Pre-bookingの価格確認

お支払い前に、最終的な予約可能価格を確認し、予約に必要な入力項目のリストをご確認ください。最新の空室状況および利用規約に基づいた、確定したオファーと予約トークンを受け取ることができます。

特定の選択内容（アクティビティ、日付、時間、チケット）をリアルタイムで検証します。
最終価格、税金・手数料、および在庫状況（価格の変更や売り切れ状況を含みます）をご確認いただけます。
予約に必要な入力項目（乗客情報やpick-upの種類など）の詳細や、予約用のセキュリティトークンを取得してください。

ステップ4：予約を作成する

確定した選択を予約に変換します。ご自身のシステム上で表示・管理できる、確定した旅程表（予約内容）を受け取ることができます。

ショッピングフローから取得した予約トークンをクエリパラメータとして送信し、Payments APIから取得したpayment_token を、旅行者情報（主たる旅行者および追加の旅行者）とともにリクエスト本文に含めて送信してください。
後で予約の照合や検索ができるよう、ご自身のアフィリエイト参照番号を記載してください。
旅程IDと、予約詳細を確認するためのリンクをお受け取りください。

ステップ5：予約の管理

お客様およびエージェント向けの予約後のワークフローをサポートします。予約完了後の包括的なツールセットをご利用いただき、既存の予約の確認、キャンセル、およびバウチャーの発行を行ってください。

旅程IDまたはアフィリエイト参照番号で予約の詳細を取得してください。
許可されている場合は予約をキャンセルし、その結果となる状態を顧客に通知してください。
イベント当日に顧客が提示するための引換券書類をご用意ください。

マーケティング費用と売上総利益

Rapid Activities APIを使用すると、marketing_fee およびgross_profit の見積もりにアクセスし、取引における予想収益を把握することができます。

marketing_fee これは、当該取引におけるパートナーの推定収益額です。これは、貴社ととの間で取り決められた取引条件に基づき、あらかじめ算出された粗利益の配分額です。Expedia Group
gross_profitこれは、お客様とExpedia Group; の間で分配される推定総利益額です。ご希望の場合は、「marketing_fee」の代わりにこのフィールドを使用し、独自の階層ロジックを適用することができます。

これらのフィールドは、「在庫状況」、「価格確認」、および「取得」の各レスポンスに含まれており、「価格確認」の段階で、在庫状況が確定してから発生した価格の変更を反映するよう再計算されます。「Retrieve」レスポンスには、予約の最新の財務状況が反映されています。そのため、その状況に変化があった場合、その値は「Price Check」で表示された内容と異なる可能性があります。

Rapid APIの実装で「Expedia Affiliate Collect」（EAC)）が有効になっている場合、「空室状況および料金確認」のレスポンスに「marketing_fee_eac」も表示されます。これは、「EAC」の給付経路に特有の推定所得額を示しています。「Retrieve」レスポンスでは、予約の完了に実際に使用された支払いパスと一致するフィールドが返されます。

ご希望であれば、これら3つのパラメータすべてへのアクセスを設定することができます。この機能を有効にしたい場合は、アカウントマネージャーまでご連絡ください。

返金可能な料金

Rapid Activities APIでは、「Refundable Rate」属性によるアクティビティのフィルタリングに対応しており、指定されたキャンセル期間内にキャンセルされた場合に返金が行われるアクティビティを特定することができます。この機能は、独自のフィルタリングロジックの必要性を軽減し、より柔軟なキャンセルポリシーを適用した旅行プランを旅行者に提示することを目的としています。

払い戻し可能なアクティビティの絞り込み

払い戻し可能な料金については、属性ID 25のattribute_id パラメータをご使用ください。

GET /v2/regions/{region_id}/activities?attribute_id=25

注：旅行者にキャンセル規約を表示する際は、レスポンスに含まれるポリシー情報を引き続きご利用ください。

リクエストの例

GET /experiences/activities/content?language=en-US&activity_id=703295&activity_id=973888&activity_id=975441&activity_id=1006352&supported_booking_data_types=*&attribute_id=25

通知

Rapid Activities APIでは、予約に影響を与えるイベントに対するプッシュ通知に対応するようになりました。これにより、ポーリングを行わなくても、お客様のシステムをRapid APIと同期させることができます。

>> 通知について詳しくはこちら

エラー応答のテスト

特定のRapid Activities APIメソッドに対してテストリクエストを送信するには、ShoppingまたはBookingリクエストに「test」という名前のHTTPヘッダーを追加し、以下の表から適切な値を使用してください。テストヘッダーを送信しなかった場合、または無効なテストヘッダーを送信した場合は、リクエストが本番環境で処理されてしまいます。

注：テスト用ヘッダーを使用すると静的なメッセージが返されるため、返されるレートやコンテンツは、テスト対象のアクティビティとは関連性がない場合があります。

ショッピングおよびコンテンツAPI

Test ヘッダーの値	HTTP コードとレスポンス	ステータス
スタンダード	200 OK（標準的な成功応答）	Success
`bad_link`	400不正なリクエスト（リンクエラー）	エラー
`invalid_input`	400 Bad Request（無効な入力）	エラー
`internal_server_error`	500内部サーバーエラー（不明なエラー）	エラー
`service_unavailable`	503サービスは利用できません	エラー

Booking API

Test ヘッダーの値	HTTP コードとレスポンス	ステータス
スタンダード	200 OK（標準的な成功応答）	Success
`bad_link`	400不正なリクエスト（リンクエラー）	エラー
`invalid_input`	400不正なリクエスト（無効な入力）	エラー
`price_mismatch`	409競合（価格の不一致）	エラー
`sold_out`	410コンフリクト（完売）	エラー
`internal_server_error`	500内部サーバーエラー（不明なエラー）	エラー
`service_unavailable`	503サービスは利用できません	エラー

API の詳細

このページで「activity-related」エンドポイントの定義を確認した後、Postmanなどのテスト用ソフトウェアを使用して、例やスキーマ定義と実際の出力結果がどのように異なるかを確認してください。このAPIがパイロット段階を終えた際には、そのエンドポイントも当社のAPI Explorerに追加される予定です。