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