Specyfikacja dzierżawy

Dzierżawa tymczasowo zachowuje własność żądanego przedziału.

Backend partnera weryfikuje, czy żądany przedział czasu dla spotkań jest prawidłowy i są wciąż dostępne. Wewnętrznie partner tworzy tymczasową blokadę karty żądany przedział, który zgodnie z ustawieniami wygasa automatycznie o lease_expiration_time Backend ma uprawnienia do modyfikowania lease_expiration_time, np. jeśli żądany czas dzierżawy jest zbyt długi. Utworzona umowa dzierżawy jest zwracana klientowi.

Nasz interfejs API do rezerwacji zapewnia opcjonalną pomoc dotyczącą leasingu. Dzięki wsparciu leasingu utworzenie dzierżawy dla żądanego przedziału to pierwszy krok podczas tworzenia Rezerwuję.

// 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 najemcach

Obsługa najmu jest opcjonalna. Dotyczy to partnerów, którzy są zainteresowani i wdrożyć pomoc. Skontaktuj się z Centrum działań, aby określić, kwalifikacji, zanim zaczniesz.

Aby obsługiwać dzierżawę, należy wdrożyć zalecany zestaw interfejsu API w wersji 2. cale dodawanie,

  • Obecna wartość CreateLease: niezbędne do wdrożenia.
  • Obecna wartość CreateBooking: które są wymagane i które muszą korzystać z informacji o dzierżawie. Partner(ka) backend dokonuje rezerwacji z podanym numerem najmu.

wymagania interfejsu API w wersji 2 mają również zastosowanie do obsługi dzierżawy; Ponadto

  • Obecna wartość CreateBooking: ma korzystać z pliku referencyjnego najmu. Podczas dokonywania rezerwacji w partner konsumuje najemcę i unieważnia go dla żadnego więcej rezerwacji. Partner odpowiada również za weryfikację za pomocą przedziału w wiadomości z prośbą.
  • Jako dodatkowy kod błędu gRPC używany jest komunikat NOT_FOUND, jeśli podano odwołanie do dzierżawy. a identyfikator najmu jest nieznany partnerowi.
.
Rysunek: tworzenie rezerwacji wynajmu
.