Umowa najmu tymczasowo przyznaje prawo własności do wybranego przedziału.
Backend partnera sprawdza, czy żądany termin spotkania jest prawidłowy i nadal dostępny. Wewnętrznie partner tworzy tymczasową blokadę dla żądanego przedziału czasu, która jest skonfigurowana tak, aby automatycznie wygasała o lease_expiration_time. Backend może modyfikowaćlease_expiration_time, np. jeśli żądany czas trwania dzierżawy jest zbyt długi.
Utworzona dzierżawa zostanie zwrócona klientowi.
Nasz interfejs API rezerwacji zapewnia opcjonalną obsługę umowy najmu. W przypadku obsługi dzierżawy pierwszym krokiem podczas tworzenia rezerwacji jest utworzenie dzierżawy dla żądanego przedziału czasu.
// 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; }
Dodatkowe informacje o umowach najmu
Obsługa dzierżawy jest opcjonalna. Dotyczy to partnerów, którzy są zainteresowani wdrożeniem tej funkcji. Zanim zaczniesz, skontaktuj się z Centrum działań, aby sprawdzić, czy kwalifikujesz się do tej funkcji.
Aby obsługiwać dzierżawę, należy wdrożyć zalecany zestaw interfejsów API w wersji 2. Dodatkowo:
- CreateLease musi być zaimplementowana.
- CreateBooking musi być wdrożona i powinna korzystać z odniesienia do rezerwacji. Backend partnera dokonuje rezerwacji na podstawie podanego numeru referencyjnego najmu.
Wymagania interfejsu API w wersji 2 dotyczą też obsługi dzierżawy. Dodatkowo:
- CreateBooking ma używać odniesienia do dzierżawy. Podczas dokonywania rezerwacji z użyciem podanego odwołania do rezerwacji partner wykorzystuje rezerwację i unieważnia ją na potrzeby dalszych rezerwacji. Partner jest również odpowiedzialny za weryfikację utworzonej rezerwacji za pomocą przedziału czasowego w wiadomości z żądaniem.
- Jako dodatkowy kod błędu gRPC używany jest kod NOT_FOUND, jeśli podano odniesienie do dzierżawy, a identyfikator dzierżawy jest nieznany partnerowi.
