Phương thức UpdateBooking

Yêu cầu

Yêu cầu cập nhật yêu cầu đặt chỗ

Thông báo yêu cầu chứa thông tin cập nhật trong trường đặt phòng, đồng thời liệt kê đường dẫn của tất cả các trường đặt phòng cần được cập nhật trong trường update_mask. Ví dụ: trường update_mask của yêu cầu lên lịch lại cho một lượt đặt phòng hiện có chứa hai đường dẫn sau:

  paths: "start_time"
  paths: "duration"

Hãy xem FieldMask (Mặt nạ trường) để biết thêm thông tin.

Giá trị trả về

Phản hồi đặt trước

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

• Là giá trị INVALID_ARGUMENT nếu mặt nạ cho trường (field mask) được cung cấp chứa giá trị không hợp lệ hoặc bất kỳ trường Đặt phòng mới nào được cập nhật đều không hợp lệ. Điều này bao gồm cả trường hợp mà logic kinh doanh không cho phép cập nhật trường, chẳng hạn như vì đã quá muộn để huỷ.
• NOT_FOUND nếu không xác định được mã đặt phòng mà bạn cung cấp
• Là giá trị RESOURCE_EXHAUSTED nếu khung giờ tương ứng với thời gian bắt đầu mới không có sẵn để đặt trước.

// Request to update a [ext.maps.booking.partner.v0.Booking]
message UpdateBookingRequest {
  // Field mask of all booking fields to be updated
  google.protobuf.FieldMask update_mask = 1;

  // The booking to be updated
  // The following fields can be set in a booking:
  // - status, to cancel a booking.
  // - start_time and duration to reschedule a booking.
  Booking booking = 2;
}

// Response with the updated [ext.maps.booking.partner.v0.Booking]
message UpdateBookingResponse {
  // The updated booking
  Booking booking = 1;

  // The updated user payment option originally used to pay for this booking.
  // This should be set if the UpdateBookingRequest results in a change to
  // the UserPaymentOption.
  // For instance, if the booking is canceled, the UserPaymentOption should
  // reflect an additional credit to the user. In the case of a multi-use
  // payment option, the current_count should be increased by one to
  // allow the user to create another booking with this payment option. In the
  // case of a single-use payment option, a new single-use user payment option
  // should be returned.
  UserPaymentOption user_payment_option = 2;
}