Obsługa tworzenia najmu jest opcjonalna. Obowiązują partnerów, którzy zainteresowanym wdrożeniem tej funkcji. Zanim zaczniesz, skontaktuj się z Centrum działań, aby sprawdzić, czy spełniasz wymagania.
Utworzenie umowy najmu to pierwszy krok podczas tworzenia rezerwacji w ramach zespołu pomocy Lease. Backend partnera sprawdza, czy żądany termin spotkań jest prawidłowy i i dostępności informacji. Wewnętrznie partner tworzy tymczasową blokadę żądanej kwoty. przedział czasu, który wygasa automatycznie po lease_expiration_time. backend może modyfikować wartość lease_expiration_time, np. jeśli żądany najemca czas jest zbyt długi. Utworzona umowa dzierżawy jest zwracana klientowi. Później Klient prosi o utworzenie rezerwacji dzierżawy.
Jeśli utworzenie najmu nie powiedzie się z powodu błędu logiki biznesowej, błąd powinien wyglądać tak: wypełnione w odpowiedzi. Zobacz rezerwację Błąd w przypadku bardziej szczegółowe informacje.
Wyślij prośbę
CreateLeaseRequest
Zwracana wartość
CreateLeaseResponse
Wymagania:
- Parametr lease_id musi zostać utworzony przez backend partnera i ustawiony w CreateLeaseResponse.
- Parametr lease_expiration_time musi być ustawiony w metodzie CreateLeaseResponse.
- Jeśli w żądaniu CreateLeaseRequest określono pole zasobów, musi ono być ustawiony w metodzie CreateLeaseResponse i pasować do metody CreateLeaseRequest.
- Wszystkie inne pola w metodzie CreateLeaseResponse muszą być ustawione i zgodne CreateLeaseRequest.
Kanoniczne kody błędów gRPC
INVALID_ARGUMENT(nieprawidłowy identyfikator sprzedawcy, identyfikator usługi lub czas przedziałów specyfikacja)
// Request to create a [ext.maps.booking.partner.v2.Lease] for a slot in the // inventory. The expiration time in the returned Lease may be modified by the // backend, e.g. if the requested lease period is too long. message CreateLeaseRequest { // The lease to be created with information about the appointment slot // (required) Lease lease = 1; } // Response for the [ext.maps.booking.partner.v2.CreateLease] RPC with the // created [ext.maps.booking.partner.v2.Lease] message CreateLeaseResponse { // The created [ext.maps.booking.partner.v2.Lease] (required) Lease lease = 1; // If creating a lease fails, this field should reflect the business logic // error (e.g., slot has become unavailable) and lease field is expected to be // unset. (required if failure occurs) BookingFailure booking_failure = 2; }