Phương thức CreateBooking

Yêu cầu

Tạo yêu cầu đặt trước

Giá trị trả về

Tạo phản hồi đặt trước

Hiệu ứng phụ

CreateBooking tiêu thụ một Yêu cầu thuê, khiến cho các lượt đặt trước sau này không hợp lệ.

Mã lỗi gRPC chính tắc

• INVALID_ARGUMENT nếu ClientInformation được cung cấp không hợp lệ, ví dụ: do thiếu trường
• NOT_FOUND nếu mã thuê được cung cấp không hợp lệ.
• RESOURCE_EXHAUSTED (nếu khung giờ không còn trống kể từ khi tạo hợp đồng thuê, ví dụ: do xung đột việc đặt phòng)
• ALREADY_EXISTS (nếu khách hàng đã có một lượt đặt trước cho khoảng thời gian đó)

// Request to create a [ext.maps.booking.partner.v0.Booking] for an inventory
// slot. Consumes the lease.
message CreateBookingRequest {
  // The lease that is being confirmed to make this booking
  LeaseReference lease_ref = 1;

  // Personal information of the client making the appointment
  ClientInformation client_information = 2;

  // Information about payments. If the booking request does not succeed,
  // payment authorizations are automatically canceled.
  PaymentInformation payment_information = 3;

  // 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).
  PaymentProcessingParameters payment_processing_parameters = 4;
}

// Response with the created [ext.maps.booking.partner.v0.Booking] for an
// inventory slot
message CreateBookingResponse {
  // The created booking
  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.
  UserPaymentOption user_payment_option = 2;
}