顧客は、リクエストしたスロットの空き状況を確認し、スロットに空きがある通知を受けた後に、予約の作成をリクエストします。パートナー バックエンドはリクエストされたスロットを予約し、成功した場合はそのスロットを返し、失敗した場合(スロットに空きがなくなった場合や、お支払いが無効な場合など)はビジネス ロジックのエラーを返します。
このステップでは、ユーザーとお支払いに関する情報が提供されます。
ビジネス ロジックのいずれかのエラーが原因で予約の作成に失敗した場合は、レスポンスにそのエラーを入力する必要があります。詳しくは、予約の失敗をご覧ください。
リクエスト
CreateBookingRequest
戻り値
CreateBookingResponse
正規 gRPC エラーコード
INVALID_ARGUMENT
(フィールドの指定漏れなどにより、指定された UserInformation が無効な場合)
// Request to create a [ext.maps.booking.partner.v2.Booking] for an inventory // slot. Consumes the lease if provided. message CreateBookingRequest { // The inventory slot that is being requested to make this booking. // If lease_ref is provided, slot must match the lease; slot is provided for // the partner to verify the lease information. // If lease_ref is absent, then create the booking for the slot. (required) Slot slot = 1; // The lease that is being confirmed to make this booking. // If lease_ref is provided, then create the booking using the lease. // (optional) LeaseReference lease_ref = 2; // Personal information of the user making the appointment (required) UserInformation user_information = 3; // Information about payments. When payment authorizations are handled by // Google, if the booking request does not succeed, payment authorizations are // automatically canceled. (optional) PaymentInformation payment_information = 4; // The parameters to be used if the payment is processed by the partner // (i.e. payment_information.payment_processed_by is equal to // PROCESSED_BY_PARTNER). (optional) PaymentProcessingParameters payment_processing_parameters = 5; // Idempotency token for [ext.maps.booking.partner.v2.CreateBooking] requests. // (required) string idempotency_token = 6; // A string from the user which contains any special requests or additional // information that they would like to notify the merchant about. (optional) string additional_request = 7; } // Response with the created [ext.maps.booking.partner.v2.Booking] for an // inventory slot message CreateBookingResponse { // The created booking (required) Booking booking = 1; // The updated user payment option used in this booking. // If a new payment option was purchased to pay for the booking, this should // be a newly created user payment option. // If an already purchased user payment option was used for this booking, // this should reflect an updated version of that user payment option. // (optional) UserPaymentOption user_payment_option = 2; // If creating a booking fails, this field should reflect the business logic // error (e.g., slot has become unavailable) and all other fields in the // CreateBookingResponse message are expected to be unset. (required if // failure occurs) BookingFailure booking_failure = 3; }