Umowa dzierżawy tymczasowo przenosi prawa własności do żądanego pokoju.
Backend partnera weryfikuje, czy żądany termin jest prawidłowy i nadal dostępny. Wewnątrz partner tworzy tymczasowe zablokowanie żądanego okienka, które automatycznie wygasa o godzinielease_expiration_time. Backend może modyfikować lease_expiration_time, np. jeśli żądany czas dzierżawy jest zbyt długi.
Utworzony wynajem zostanie zwrócony klientowi.
Nasz interfejs rezerwacji zapewnia opcjonalną obsługę leasingu. W przypadku obsługi leasingu pierwszym krokiem podczas tworzenia rezerwacji jest utworzenie leasingu dla żądanego slotu.
// 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; }
Dodatkowe informacje o umowach leasingowych
Obsługa leasingu jest opcjonalna. Dotyczy partnerów, którzy są zainteresowani wdrożeniem pomocy. Przed rozpoczęciem skontaktuj się z Centrum działań, aby sprawdzić, czy spełniasz wymagania.
Aby obsługiwać leasing, musisz zaimplementować zalecany zestaw interfejsu API w wersji 2. Ponadto
- Musisz wdrożyć funkcję CreateLease.
- Musisz wdrożyć zdarzenie CreateBooking, które powinno używać odwołania do umowy najmu. Partner backend rezerwuje usługę z podanym odniesieniem do umowy najmu.
Wymagania interfejsu API w wersji 2 dotyczą też obsługi leasingu. Dodatkowo:
- CreateBooking ma używać odwołania do umowy leasingowej. Gdy dokonujesz rezerwacji z podanym odniesieniem do leasingu, partner wykorzystuje leasing i czyni go nieważnym w przypadku dalszych rezerwacji. Partner jest też odpowiedzialny za weryfikację utworzonego rezerwowania za pomocą slotu w wiadomości z prośbą.
- Jako dodatkowy kod błędu gRPC używany jest kod NOT_FOUND, jeśli podano referencję lease, a identyfikator lease jest nieznany partnerowi.
