CreateBooking の準備完了マイルストーン タスクを完了するには、CreateBooking
メソッドを正常にビルドして提供する必要があります。このメソッドは、ユーザーが予約を作成しようとしたときに呼び出されます。予約が正常に作成されると、レスポンスには、今後のリクエストや更新で予約を参照するための固有の booking_id が含まれます。
CreateBooking タスクの要件
- サンドボックスで
CreateBookingリクエストが 10 件あり、成功率が 90% 以上であること。 - 本番環境で
CreateBookingリクエストが 3 件あり、成功率が 90% 以上であること。
CreateBooking の基本
ユーザーが予約を開始すると、CreateBooking リクエストがパートナーの予約サーバーに送信されます。リクエストに対するレスポンスは、予約が成功したか失敗したかを示します。予約が失敗した場合は、レスポンスに失敗のビジネス ロジック エラーを含める必要があります。たとえば、スロットが利用できなくなった場合や、同じユーザーがすでにスロットを予約している場合などです。
ユーザーが予約を作成すると、そのユーザーの氏名、電話番号、メールアドレスが販売者に送信されます。詳しくは、 アカウントのマッチングと作成のポリシーをご覧ください。
べき等性
ネットワーク経由の通信は常に信頼できるわけではなく、Google のシステムは、レスポンスを受信でない場合に HTTP リクエストを再試行することがあります。そのため、状態を変化させるメソッドは、すべてべき等性を確保する必要があります。
CreateBookingUpdateBooking
UpdateBooking 以外のすべてのリクエスト
メッセージには、リクエストを一意に識別するため、べき等性のトークンが含まれます。これにより、1 つのリクエストを作成する目的で再試行された
REST 呼び出しと、2 つの別々のリクエストを区別できます。UpdateBooking
の予約エントリの各 ID は、それらを一意に識別するのに役立つため、べき等性のトークンはリクエストに含まれません。
予約サーバーでのべき等性の処理方法の例は以下のとおりです。
成功した
CreateBookingHTTP レスポンスには、作成された予約が含まれます。場合によっては、予約フローの一部として決済が処理されます。同じidempotency_tokenを持つ同じCreateBookingRequestを 2 回受け取った場合は、同じCreateBookingResponseを返す必要があります。2 回目の予約は作成されず、その場合、ユーザーは 1 回のみ請求されます。
べき等性の要件は、状態を変更するすべてのメソッドに適用されます。