アクション センターがユーザーの代わりに予約を作成、更新するためのコールバックを行うには、予約サーバーが必要です。これにより、アクション センターでユーザーに代わって予約を作成できます。
サンドボックスと本番環境の予約サーバーへの接続を設定する方法については、予約サーバーの認証情報を構成するをご覧ください。
リアルタイム更新に移行する前に、次の「予約サーバーの準備完了」タスクを完了してください。
- BatchAvailabilityLookup ページの読み込み完了
- BatchAvailabilityLookup スロットのクリック準備完了
- CreateBooking Ready
- UpdateBooking の準備完了
- アクション センターの [構成] [アカウント機能] で空き状況チェッカーを有効にする
サンドボックス予約フローを通じて、正確なリアルタイムの在庫情報を Booking Server リクエストに送信すると、各タスクが完了済みとしてマークされ、緑色に変わります。予約サーバーのマイルストーンは 14 日間の期間で分析されます。
REST API インターフェースを実装する
REST に基づいて API インターフェースを実装します。これにより、Google のシステムが HTTPS 経由で予約サーバー リクエストを送信できるようになります。
API インターフェースを実装するには、アクション センターのサンドボックス環境に接続する開発用またはサンドボックス用の予約サーバーを設定します。本番環境への移行は、サンドボックス サーバーのテストが完了した後に行います。
Google の予約サーバー リクエストはすべて、[予約サーバー] ページで設定した予約サーバーの URL を基準にしています。たとえば、URL を api.example.com/google に設定している場合、HealthCheck リクエストはすべて api.example.com/google/v3/HealthCheck に送信されます。
環境スイッチャーを使用して、サンドボックス環境と本番環境の両方に正しい予約サーバーのエンドポイントが設定されていることを確認します。
セキュリティと認証
予約サーバーへの通信はすべて、基本認証を使用して HTTPS 経由で行われます。サーバーの設定では、Qualys の SSL サーバー テストなどの一般公開されている SSL または TLS 検証ツールを使用することをおすすめします。
Google が予約サーバーに対して行うすべてのリクエストは、HTTPS 基本認証で認証されます。予約サーバーの基本認証情報、パスワード、ユーザー名は、アクション センターの予約サーバー設定ページで入力できます。認証情報は 6 か月ごとに変更する必要があります。
予約サーバーを構築する
予約サーバーは、統合がシステムと通信する方法を決定し、予約を作成または更新します。サンドボックスと本番環境の予約サーバーへの接続を設定するには、予約サーバーの認証情報を構成するをご覧ください。
「Google で予約」からのリクエストに対して予約サーバーが返すレスポンスには、正確なリアルタイムの在庫詳細が含まれている必要があります。次の表に、各実装のメソッドと、サービス プロトコル形式へのリンクを示します。
| メソッド | 定義 | レスポンス | HTTP リクエスト |
|---|---|---|---|
BatchAvailabilityLookup ページの読み込み |
ユーザーが販売者の [席を予約] をクリックすると、ページの読み込み時に ペイロードには、最新のフィード アップロードに基づいて、Google で予約が利用可能と見なされる多数のスロットが含まれています。 |
レスポンスには、すべてのスロット リクエストとスロットの現在の空き状況を含める必要があります。これにより、利用できないスロットが表示されなくなります。 | POST /v3/BatchAvailabilityLookup/ |
BatchAvailabilityLookup スロットのクリック |
ユーザーに予約可能な枠が表示され、ユーザーが枠をクリックすると、枠のクリックに対して BatchAvailabilityLookup リクエストが呼び出されます。 |
レスポンスは、スロットの現在の実際の空き状況を表す必要があります。スロットがクリックされる前に予約が埋まっている場合は、利用できないというレスポンスを返します。 | POST /v3/BatchAvailabilityLookup/ |
CreateBooking |
ユーザーが予約モーダルで選択した時間帯の予約を確定すると、CreateBooking リクエストが送信されます。 |
レスポンスは、予約の成功または失敗を表す必要があります。 予約が失敗した場合は、失敗の具体的な理由を返す必要があります。たとえば、 予約が正常に作成されると、レスポンスには、今後のリクエストや更新で予約を参照するための固有の |
POST /v3/CreateBooking/ |
UpdateBooking |
「Google で予約」を通じて予約を行った後、ユーザーは予約の変更を選択できます。ユーザーが予約を更新またはキャンセルすると、UpdateBooking リクエストが送信されます。 |
CreateBooking レスポンスと同様に、UpdateBooking へのレスポンスは予約の成功を表すか、失敗の具体的な理由を返す必要があります。 |
POST /v3/UpdateBooking/ |
HealthCheck |
アクション センターは、インフラストラクチャがアクティブで実行中であることを確認するために、予約サーバーに定期的に呼び出しを行います。 | HTTP ステータス コードを使って、サーバーの配信ステータスを示します。サーバーがアクティブで正常に動作している場合は、HTTP ステータス コード 200 を返します。 エラーを示す場合や、統合を一時的にオフラインにする場合は、適切な 2xx 以外の HTTP ステータス コードを返します。 |
GET /v3/HealthCheck/ |
サンドボックスの予約フロー
サンドボックスの予約フローを表示するには、アクション センターの [在庫] ビューに移動します。[在庫] ビューの [RwG - E2E] 列には、一致しており、将来の在庫があるサンドボックス販売者に対して、サンドボックス予約フローへの [Live (in Sandbox)] リンクが表示されます。
予約フローのアクションは次のとおりです。
- [RwG - E2E] リンクをクリックすると、ページの読み込み時に
BatchAvailabilityLookupリクエストがトリガーされ、販売者の既知の在庫状況が表示されます。 - 予約時間をクリックすると、
BatchAvailabilityLookupスロットクリック リクエストがトリガーされ、予約モーダルが表示されます。 - 予約モーダルで予約を完了して、
CreateBookingリクエストを送信します。 - サンドボックス環境で予約を完了すると、予約の作成に使用したアカウントに、予約の詳細が記載された確認メールが届きます。
UpdateBookingメソッドをトリガーするには、メールから予約を変更またはキャンセルします。
HealthCheck
サンドボックスと本番環境で HealthCheck メソッドを実装してください。このメソッドでは、予約サーバーの健全性ステータスを返します。これにより、Google はお客様の予約サーバーの配信状態を継続的にモニタリングできます。
リクエスト: なし
戻り値: なし
HTTP ステータス コードを使って、サーバーの配信ステータスを示します。
サーバーがアクティブで正常に動作している場合は HTTP ステータス コード 200 を返し、エラーを示す場合は、HTTP ステータス コードの 1 つを返します。