Phương thức CreateBooking

Yêu cầu

CreateBookingRequest

Giá trị trả về

CreateBookingResponse

Tác dụng phụ

CreateBooking sử dụng một Lease, khiến Lease đó không hợp lệ cho mọi lượt đặt phòng tiếp theo.

Mã lỗi gRPC chuẩn

  • 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ê bao bạn cung cấp không hợp lệ.
  • RESOURCE_EXHAUSTED (nếu vị trí đã không còn trống kể từ khi tạo hợp đồng thuê, ví dụ: do có một lượt đặt trước xung đột)
  • ALREADY_EXISTS (nếu khách hàng đã đặt trước khung giờ đó)
// 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;
}