Lease tạm thời giữ quyền sở hữu một Vị trí được yêu cầu.
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à vẫn còn trống. Về nội bộ, đối tác sẽ tạo một yêu cầu giữ chỗ tạm thời cho Khung giờ được yêu cầu. Yêu cầu này đượ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ả về cho ứng dụng khách.
API đặt phòng của chúng tôi cung cấp chế độ hỗ trợ không bắt buộc cho Lease. Với tính năng hỗ trợ cho thuê, việc tạo một Lượt thuê cho Khung giờ được yêu cầu là bước đầu tiên khi tạo một Lượt đặt trước.
// Temporary lease for an inventory slot message Lease { option features.(pb.java).nest_in_file_class = YES; // ID of the lease. // Not populated in CreateLeaseRequest. The value is chosen by the partner and // has to be returned in the response of CreateLease. (required) string lease_id = 1; // The appointment slot that the lease is created for. (required) Slot slot = 2; // Unique identifier for this lease, chosen by Reserve with Google. Serves as // an idempotency token for [ext.maps.booking.partner.v2.CreateLease] // requests. (required) string user_reference = 3; // Expiration time of the lease in UTC Timestamp (required) google.protobuf.Timestamp lease_expiration_time = 4; } // Reference to a [ext.maps.booking.partner.v2.Lease] that has been created via // [ext.maps.booking.partner.v2.CreateLease] message LeaseReference { option features.(pb.java).nest_in_file_class = YES; // Lease ID (required) string lease_id = 1; }
Thông tin bổ sung về hợp đồng thuê
Bạn không bắt buộc phải hỗ trợ hợp đồng thuê. Tính năng này áp dụng cho những đối tác muốn triển khai dịch vụ hỗ trợ. Vui lòng liên hệ với Trung tâm hành động để xác định điều kiện trước khi bắt đầu.
Để hỗ trợ hợp đồng thuê, bạn phải triển khai bộ API phiên bản 2 được đề xuất; ngoài ra,
- Bạn phải triển khai CreateLease.
- Bạn phải triển khai CreateBooking và dự kiến sẽ sử dụng thông tin tham chiếu về hợp đồng thuê. Phần phụ trợ của đối tác đặt chỗ bằng mã tham chiếu cho thuê được cung cấp.
Các yêu cầu của API phiên bản 2 cũng áp dụng cho việc hỗ trợ hợp đồng thuê; ngoài ra,
- CreateBooking dự kiến sẽ sử dụng thông tin tham chiếu về hợp đồng thuê. Khi đặt phòng bằng mã tham chiếu hợp đồng thuê được cung cấp, đối tác sẽ sử dụng hợp đồng thuê và khiến hợp đồng đó không hợp lệ cho mọi lượt đặt phòng tiếp theo. Đối tác cũng chịu trách nhiệm xác minh yêu cầu đặt phòng đã tạo bằng cách sử dụng vị trí trong thông báo yêu cầu.
- Là một mã lỗi gRPC bổ sung, NOT_FOUND được dùng nếu bạn cung cấp tham chiếu cho thuê và đối tác không biết mã thuê.