在检查所请求的空档的可用性并收到相应空档可用的信息后,客户端会请求创建预订。合作伙伴后端会针对所请求的空档进行预订,并在预订成功时返回相应空档,在失败时返回业务逻辑错误(例如,出现空档不可用或付款无效等情况)。
此步骤会提供与用户和付款相关的信息。
如果因业务逻辑错误而导致创建预订失败,则应将相应错误填充到响应中。如需了解详情,请参阅预订失败。
请求
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; }