Dzierżawa tymczasowo zachowuje prawo własności do żądanego przedziału.
Backend partnera sprawdza, czy żądany przedział czasu dla spotkania jest prawidłowy i nadal dostępny. Wewnętrznie partner tworzy tymczasową blokadę dla żądanego przedziału, która wygasa automatycznie o lease_expiration_time. Backend może modyfikować lease_expiration_time, np. jeśli żądany czas dzierżawy jest zbyt długi.
Utworzona dzierżawa zostanie zwrócona klientowi.
Nasz interfejs API rezerwacji zapewnia opcjonalną pomoc w zakresie dzierżawy. W przypadku obsługi dzierżawy pierwszym etapem tworzenia rezerwacji jest utworzenie dzierżawy żądanego przedziału.
// 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 najmu
Obsługa dzierżawy jest opcjonalna. Dotyczy to partnerów, którzy są zainteresowani wsparciem. Zanim zaczniesz, skontaktuj się z Centrum akcji, aby dowiedzieć się, czy się kwalifikujesz.
Aby można było korzystać z dzierżawy, należy wdrożyć zalecany zestaw interfejsów API w wersji 2. Dodatkowo
- Implementacja CreateLease jest wymagana.
- Implementacja CreateBooking jest wymagana i powinien korzystać z pliku referencyjnego dzierżawy. Backend partnera dokonuje rezerwacji przy użyciu podanego pliku referencyjnego najmu.
Wymagania interfejsu API w wersji 2 dotyczą również obsługi dzierżawy.
- Prawdopodobnie CreateBooking używa pliku referencyjnego dzierżawy. W przypadku rezerwacji z użyciem podanego pliku referencyjnego partner czerpie z niej wynajem i unieważnia ją w przypadku kolejnych rezerwacji. Partner jest też odpowiedzialny za weryfikację utworzonej rezerwacji za pomocą przedziału w wiadomości żądania.
- Jako dodatkowy kod błędu gRPC używany jest kod NOT_FOUND, jeśli podano refleksję dzierżawy, a partner nie rozpoznaje identyfikatora dzierżawy.
