アクション センターのエンドツーエンドの予約機能の統合の一環として、お支払いが必要な取引について、保証金、ノーショー料金、前払い在庫を予約ページにリンクアウトできるように設定できます。このようにしてお支払いを有効にすると、指定した予約ページで予約フローと取引全体を処理できます。
利用資格
特定の予約にお支払いを追加するには、次の前提条件を満たしている必要があります。
- 既存のライブ E2E 統合。
- お支払い処理に対応できる予約ページ に直接ディープリンクできること。
- お支払いのリダイレクトに関するポリシーを遵守していること。
お支払いのリダイレクトの実装手順
予約の変更
このセクションでは、予約の変更とキャンセルがお支払いのリダイレクトとどのように連携するかについて説明します。時間枠の除外やエラー処理についても説明します。
お支払いのリダイレクトによる予約
お支払いのリダイレクトを通じて作成された予約は、パートナーの予約プラットフォームで直接完了します。Google はこれらの予約を保存または管理しないため、 ユーザーは 「Google で予約」を通じて予約を表示または変更することはできません。お支払いのリダイレクトによる予約の変更やキャンセルは、パートナーのプラットフォームで直接行う必要があります。
エンドツーエンドの予約を変更する
ユーザーが既存のエンドツーエンドの予約（元々 CreateBooking を使用して作成された予約）を変更すると、Google は linkout_required_reason: PAYMENT_REQUIRED でマークされたすべての時間枠を、変更ビューの利用可能なオプションから自動的に除外します（利用不可またはグレー表示になります）。これにより、ユーザーがお支払いを完了せずにエンドツーエンドの予約をお支払いのリダイレクト（保証金が必要な時間枠など）に切り替えることを防ぎます。
UpdateBooking リクエストの処理
UpdateBooking API エンドポイントは、ユーザーをお支払いのリダイレクト フローに移行したり、リダイレクト URL を返したりすることをサポートしていません。パートナーのサーバーが、お支払いのリダイレクト（保証金が必要な時間枠など）の時間枠に対して UpdateBooking リクエストを受信した場合（たとえば、更新された空き状況がサービング キャッシュ全体に完全に反映される前にユーザーが編集を試みた場合）は、次のようになります。
booking_failureを含むUpdateBookingResponseを返してリクエストを拒否 します。- Failure Cause:
booking_failure.causeをSLOT_UNAVAILABLEに設定します。これにより、ユーザーに明確なメッセージ（"申し訳ございませんが、この時間はご利用いただけません。"）が表示され、誤った確認メールが送信されるのを防ぐことができます。 - 失敗の説明: ロギングとトラブルシューティングを容易にするため、
booking_failure.descriptionに明確な説明（"UpdateBooking not allowed on PR slots"など）を入力します。
サンドボックスでのテスト
パートナーの統合でお支払いのリダイレクトが有効になると、サンドボックス環境でこの動作を直接確認できます。
CreateBookingを使用して、標準のエンドツーエンドの予約を作成します。- 標準の時間枠と
PAYMENT_REQUIREDの時間枠を組み合わせて、空き状況の時間枠を提供します。 - サンドボックスの予約管理ビューで予約を開き、変更を試みます。
PAYMENT_REQUIREDの時間枠が利用不可（グレー表示）になっていることを確認します。 - サーバーが、
SLOT_UNAVAILABLEを使用して、有料の時間枠に対する予期しないUpdateBooking呼び出しを拒否することを確認します。