Un leasing detiene temporaneamente la proprietà di uno slot richiesto.
Il backend del partner verifica che l'appuntamento richiesto sia valido e ancora disponibile. All'interno, il partner crea una prenotazione temporanea per lo slot richiesto, che viene configurato per scadere automaticamente alle ore lease_expiration_time. Il backend è autorizzato a modificare
lease_expiration_time, ad esempio se il periodo di locazione richiesto è eccessivamente lungo.
Il lease creato viene restituito al client.
La nostra API di prenotazione fornisce il supporto facoltativo per il leasing. Con il supporto del leasing, la creazione di un leasing per lo slot richiesto è il primo passaggio per la creazione di una prenotazione.
// 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; }
Ulteriori informazioni sui leasing
Il supporto per il leasing è facoltativo. Si applica ai partner interessati all'implementazione dell'assistenza. Contatta il Centro azioni per determinare la tua idoneità prima di iniziare.
Per supportare il leasing, è necessario implementare l'insieme consigliato di API v2. Inoltre,
- È obbligatoria l'implementazione di CreateLease.
- È obbligatorio implementare CreateBooking e si prevede che utilizzi il riferimento al contratto di locazione. Il backend del partner effettua una prenotazione con il riferimento del contratto di locazione fornito.
I requisiti della versione 2 dell'API si applicano anche al supporto del leasing. Inoltre,
- CreateBooking dovrebbe utilizzare il riferimento del contratto di locazione. Quando effettua una prenotazione con il riferimento del contratto di locazione fornito, il partner utilizza il contratto e lo rende non valido per eventuali altre prenotazioni. Il partner è inoltre responsabile della verifica della prenotazione creata utilizzando lo slot nel messaggio di richiesta.
- Come codice di errore gRPC aggiuntivo, NOT_FOUND viene utilizzato se viene fornito il riferimento del contratto di locazione e l'ID contratto di locazione è sconosciuto al partner.
