Phương thức CreateLease

Bạn không bắt buộc phải hỗ trợ việc tạo hợp đồng thuê. Chính sách này áp dụng cho những đối tác muốn triển khai chức năng này. Vui lòng liên hệ với Actions Center để xác định xem bạn có đủ điều kiện hay không trước khi bắt đầu.

Tạo hợp đồng thuê là bước đầu tiên khi tạo yêu cầu đặt phòng có hỗ trợ Hợp đồng thuê. Hệ thống phụ trợ của đối tác xác minh rằng khung giờ hẹn được yêu cầu là hợp lệ và còn trống. Về nội bộ, đối tác tạo một khoản giữ tạm thời cho vị trí được yêu cầu. Khoản giữ này được thiết lập để tự động hết hạn tại lease_expiration_time. Phần phụ trợ được phép sửa đổi lease_expiration_time, ví dụ: nếu thời gian thuê được yêu cầu quá dài. Hợp đồng thuê đã tạo sẽ được trả về cho ứng dụng khách. Sau đó, ứng dụng khách yêu cầu tạo một lượt đặt trước cho hợp đồng thuê.

Nếu không tạo được hợp đồng thuê do bất kỳ lỗi logic nghiệp vụ nào, thì lỗi đó sẽ được điền vào phản hồi. Hãy xem phần Lỗi đặt chỗ để biết thông tin chi tiết.

Yêu cầu

CreateLeaseRequest

Giá trị trả về

CreateLeaseResponse

Yêu cầu:

• đối tác phụ trợ phải tạo lease_id và đặt trong CreateLeaseResponse.
• Bạn phải đặt lease_expiration_time trong CreateLeaseResponse.
• Nếu trường tài nguyên được chỉ định trong CreateLeaseRequest, thì trường này phải được đặt trong CreateLeaseResponse và khớp với CreateLeaseRequest.
• Bạn phải đặt tất cả các trường khác trong CreateLeaseResponse và khớp với CreateLeaseRequest.

Mã lỗi gRPC chuẩn

• INVALID_ARGUMENT (mã người bán, mã dịch vụ hoặc quy cách thời gian đặt lịch hẹn không hợp lệ)

// Request to create a [ext.maps.booking.partner.v2.Lease] for a slot in the
// inventory.  The expiration time in the returned Lease may be modified by the
// backend, e.g. if the requested lease period is too long.
message CreateLeaseRequest {
  option features.(pb.java).nest_in_file_class = YES;

  // The lease to be created with information about the appointment slot
  // (required)
  Lease lease = 1;
}

// Response for the [ext.maps.booking.partner.v2.CreateLease] RPC with the
// created [ext.maps.booking.partner.v2.Lease]
message CreateLeaseResponse {
  option features.(pb.java).nest_in_file_class = YES;

  // The created [ext.maps.booking.partner.v2.Lease] (required)
  Lease lease = 1;

  // If creating a lease fails, this field should reflect the business logic
  // error (e.g., slot has become unavailable) and lease field is expected to be
  // unset. (required if failure occurs)
  BookingFailure booking_failure = 2;
}