Việc hỗ trợ tạo gói thuê bao là không bắt buộc. Hướng dẫn này áp dụng cho các đối tác muốn triển khai chức năng này. Vui lòng liên hệ với Trung tâm hành động để 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 một lượt đặt phòng thông qua bộ phận hỗ trợ Thuê. Phần phụ trợ của đối tác sẽ xác minh rằng khung giờ nhận đặt hẹn được yêu cầu là hợp lệ và có thể sử dụng. Trong nội bộ, đối tác tạo một khoản phí tạm thời cho khoảng thời gian được yêu cầu, được thiết lập để tự động hết hạn vào 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ả lại cho ứng dụng khách. Sau đó, khách hàng yêu cầu tạo một lượt đặt phòng cho thuê.
Nếu không tạo được thoả thuận thuê do bất kỳ lỗi logic kinh doanh nào, thì lỗi đó sẽ được điền vào phản hồi. Vui lòng xem phần Không đặt chỗ được để biết thông tin chi tiết.
Yêu cầu
Tạo yêu cầu cho thuê
Giá trị trả về
CreateL miềnResponse (Phản hồi)
Yêu cầu:
- lease_id phải do phần phụ trợ của đối tác tạo và đặt trong CreateL miềnResponse.
- Bạn phải đặt lease_expiration_time trong CreateL chịuResponse.
- Nếu trường tài nguyên được chỉ định trong CreateLeesRequest, thì trường này phải được đặt trong CreateLKhả năng phản hồi và khớp với CreateL miềnRequest.
- Tất cả các trường khác trong CreateL miềnResponse phải được đặt và khớp với CreateL miềnRequest.
Mã lỗi gRPC chính tắc
INVALID_ARGUMENT(mã người bán, mã dịch vụ hoặc thông số thời gian 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 {
// 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 {
// 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;
}