Kontrat, istenen Slot'un sahipliğini geçici olarak elinde bulundurur.
İş ortağının arka ucu, istenen randevu aralığının geçerli ve hâlâ kullanılabilir olduğunu doğrular. Dahili olarak iş ortağı, istenen Slot için geçici bir bekletme oluşturur. Bu bekletme, lease_expiration_time tarihinde otomatik olarak sona erecek şekilde ayarlanır. Arka ucun lease_expiration_time öğesini değiştirmesine izin verilir (ör. istenen kiralama süresi aşırı uzunsa).
Oluşturulan kiralama, müşteriye iade edilir.
Rezervasyon API'miz, Lease için isteğe bağlı destek sağlar. Kiralama desteği sayesinde, istenen Slot için bir Kiralama oluşturmak, rezervasyon oluşturmanın ilk adımıdı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;
}
Kiralamalar 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 uygun olup olmadığınızı belirlemek için lütfen Actions Center ile iletişime geçin.
Kiralamayı desteklemek için önerilen API v2 setinin uygulanması gerekir. Buna ek olarak,
- CreateLease işleminin uygulanması gerekir.
- CreateBooking uygulanması zorunludur ve kira referansı kullanması beklenir. İş ortağı arka uç, sağlanan kiralama referansıyla rezervasyon yapar.
API v2 şartları, kiralama desteği için de geçerlidir.
- CreateBooking'ın kiralama referansı kullanması beklenir. İş ortağı, sağlanan kiralama referansıyla rezervasyon yaparken kiralamayı kullanır 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ğlanmışsa ve kiralama kimliği iş ortağı tarafından bilinmiyorsa ek bir gRPC hata kodu olarak NOT_FOUND kullanılır.
