เมธอด CreateBooking

ไคลเอ็นต์ขอสร้างการจองหลังจากตรวจสอบความพร้อมของ ช่วงเวลาที่ขอและได้รับว่าช่วงเวลานั้นพร้อมให้บริการ แบ็กเอนด์ของพาร์ทเนอร์จะทำการจองช่วงเวลาที่ขอ และแสดงช่วงเวลาเมื่อดำเนินการสำเร็จ หรือแสดงข้อผิดพลาดทางตรรกะทางธุรกิจ (เช่น หากช่วงเวลาไม่พร้อมใช้งาน หรือหากการชำระเงินไม่ถูกต้อง เป็นต้น) เมื่อดำเนินการไม่สำเร็จ

ขั้นตอนนี้จะให้ข้อมูลเกี่ยวกับผู้ใช้และการชำระเงิน

หากการสร้างการจองไม่สำเร็จเนื่องจากข้อผิดพลาดทางตรรกะทางธุรกิจ ข้อผิดพลาดควร แสดงในการตอบกลับ ดูข้อมูลโดยละเอียดได้ที่การจอง ล้มเหลว

หมายเหตุ: คาดว่า lease_ref ใน CreateBookingRequest จะไม่มี ดูข้อมูลเพิ่มเติมได้ที่ข้อกำหนด การเช่า

คำขอ

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

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

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