เมธอด CreateBooking

คำขอ

CreateBookingRequest

ค่าที่ส่งคืน

CreateBookingResponse

ผลข้างเคียง

CreateBooking จะใช้ Lease ซึ่งทำให้การจองอื่นๆ ไม่ถูกต้อง

รหัสข้อผิดพลาด gRPC มาตรฐาน

• INVALID_ARGUMENT หาก ClientInformation ที่ระบุไม่ถูกต้อง เช่น เนื่องจาก ไม่มีฟิลด์
• NOT_FOUND หากรหัสสัญญาเช่าที่ระบุไม่ถูกต้อง
• RESOURCE_EXHAUSTED (หากสล็อตไม่พร้อมใช้งานตั้งแต่สร้างสัญญาเช่า เช่น เนื่องจากมีการจองที่ขัดแย้งกัน)
• ALREADY_EXISTS (หากลูกค้ามีการจองช่วงเวลาดังกล่าวอยู่แล้ว)

// Request to create a [ext.maps.booking.partner.v0.Booking] for an inventory
// slot. Consumes the lease.
message CreateBookingRequest {
  option features.(pb.java).nest_in_file_class = YES;

  // 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 {
  option features.(pb.java).nest_in_file_class = YES;

  // 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;
}