Kiralama, istenen bir yerin sahipliğini geçici olarak elinde tutar.
İş ortağının arka ucu, istenen randevu aralığının geçerli ve hâlâ kullanılabilir olduğunu doğrular. İş ortağı, dahili olarak istenen yer için geçici bir muhafaza oluşturur. Bu muhafaza, lease_expiration_time tarihinde otomatik olarak sona erecek şekilde ayarlanır. Arka uç, lease_expiration_time değerini değiştirebilir. Örneğin, istenen kiralama süresi aşırı uzunsa.
Oluşturulan kiralama istemciye döndürülür.
Rezervasyon API'miz, kiralama için isteğe bağlı destek sunar. Kiralama desteğiyle, istenen yuva için kiralama oluşturmak, rezervasyon oluştururken atılacak ilk adımdır.
// 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; }
Kiralama sözleşmeleri hakkında ek bilgiler
Kiralama desteği isteğe bağlıdır. Destek özelliğini uygulamak isteyen iş ortakları için geçerlidir. Başlamadan önce uygunluğu belirlemek için lütfen İşlemler Merkezi ile iletişime geçin.
Kiralama özelliğini desteklemek için önerilen API v2 kümesinin uygulanması gerekir. Ayrıca,
- CreateLease'in uygulanması gerekir.
- CreateBooking'in uygulanması ve kiralama referansının kullanılması gerekir. İş ortağı arka ucu, sağlanan kiralama referansıyla rezervasyon yapar.
API v2'nin koşulları kiralama desteği için de geçerlidir. Ayrıca,
- CreateBooking, kira referansı kullanmalıdır. Sağlanan kiralama referansıyla rezervasyon yapıldığında iş ortağı kiralama işlemini kullanır ve başka rezervasyonlar için geçersiz kılar. İş ortağı, istek mesajındaki yer kullanılarak oluşturulan rezervasyonu doğrulamaktan da sorumludur.
- Ek bir gRPC hata kodu olarak, kiralama referansı sağlanırsa ve kiralama kimliği iş ortağı tarafından bilinmiyorsa NOT_FOUND kullanılır.
