Il supporto per la creazione del lease è facoltativo. Si applica ai partner che interessati a implementare questa funzionalità. Contatta il Centro azioni per determinare l'idoneità prima di iniziare.
Creare il leasing è il primo passaggio quando si crea una prenotazione con l'assistenza Lease. Il backend del partner verifica che lo spazio per appuntamenti richiesto sia valido e disponibili. Internamente, il partner crea una trattenuta temporanea per la richiesta slot machine, che è configurato per scadere automaticamente al lease_expiration_time. La può modificare lease_expiration_time, ad esempio se il leasing richiesto è troppo lungo. Il lease creato viene restituito al client. Quindi, il cliente richiede di creare una prenotazione per il leasing.
Se la creazione di un lease non riesce a causa di un errore della logica di business, l'errore deve essere compilate nella risposta. Vedi Prenotazione Errore per informazioni dettagliate.
Richiedi
CreateLeaseRequest
Valore restituito
CreateLeaseResponse
Requisiti:
- lease_id deve essere creato dal backend del partner e impostato nel CreateLeaseResponse.
- lease_expiration_time deve essere impostato in CreateLeaseResponse.
- Se il campo Resources è specificato in CreateLeaseRequest, deve essere in CreateLeaseResponse e corrisponda a CreateLeaseRequest.
- Tutti gli altri campi della CreateLeaseResponse devono essere impostati e corrispondere al valore CreateLeaseRequest.
Codici di errore gRPC canonici
INVALID_ARGUMENT
(ID commerciante, ID servizio o tempo di slot non valido specifica)
// 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; }