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

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

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

Test ヘッダーの値	HTTP コードとレスポンス	ステータス
スタンダード	200 OK（標準的な成功応答）	Success
`bad_link`	400不正なリクエスト（リンクエラー）	エラー
`invalid_input`	400不正なリクエスト（無効な入力）	エラー
`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に追加される予定です。