Kiralama, istenen bir Slot'un sahipliğini geçici olarak elinde tutar.
İş ortağının arka uç sistemi, istenen randevu aralığının geçerli ve hâlâ müsait olup olmadığını doğrular. İş ortağı, istenen Slot için dahili olarak geçici bir bekletme işlemi oluşturur. Bu işlem, lease_expiration_time tarihinde otomatik olarak sona erecek şekilde ayarlanır. Arka uç, lease_expiration_time değerini değiştirebilir (ör. istenen kiralama süresi çok uzunsa).
Oluşturulan kiralama istemciye döndürülür.
Rezervasyon API'miz, Kiralama için isteğe bağlı destek sağlar. Kiralama desteğiyle, rezervasyon oluştururken ilk adım, istenen aralık için kiralama oluşturmaktır.
// Temporary lease for an inventory slot message Lease { // 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 { // Lease ID (required) string lease_id = 1; }
Kiralama hakkında ek bilgiler
Kiralama desteği isteğe bağlıdır. Desteği uygulamak isteyen iş ortakları için geçerlidir. Başlamadan önce uygunluk durumunuzu öğrenmek için lütfen İşlem Merkezi ile iletişime geçin.
Kiralamayı desteklemek için önerilen API v2 grubu uygulanmalıdır. Ayrıca:
- CreateLease işlevinin uygulanması gerekir.
- CreateBooking işlevinin uygulanması gerekir ve kira referansının kullanılması beklenir. İş ortağı arka uç, sağlanan kira referansıyla rezervasyon yapar.
API v2'nin şartları, kiralama desteği için de geçerlidir. Ayrıca,
- CreateBooking'in kira referansını kullanması beklenir. İş ortağı, sağlanan kira referansıyla rezervasyon yaparken kirayı tüketir ve sonraki rezervasyonlar için geçersiz hale getirir. İş ortağı, istek mesajındaki slotu kullanarak oluşturulan rezervasyonu doğrulamaktan da sorumludur.
- Kiralama referansı sağlanırsa ve iş ortağı kiralama kimliğini bilmiyorsa ek bir gRPC hata kodu olarak NOT_FOUND kullanılır.
