Un contratto di locazione detiene temporaneamente la proprietà di uno slot richiesto.
Il backend del partner verifica che lo spazio per l'appuntamento richiesto sia valido e
ancora disponibile. Internamente, il partner crea una prenotazione temporanea per lo
slot richiesto, che è configurato per scadere automaticamente alle
lease_expiration_time. Il backend è autorizzato a modificare
lease_expiration_time, ad esempio se il tempo di lease richiesto è eccessivamente lungo.
Il lease creato viene restituito al client.
La nostra API di prenotazione fornisce il supporto facoltativo per il contratto di locazione. Con il supporto del contratto di locazione, la creazione di un contratto di locazione per lo slot richiesto è il primo passaggio per creare una prenotazione.
// Temporary lease for an inventory slot message Lease { option features.(pb.java).nest_in_file_class = YES; // 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 { option features.(pb.java).nest_in_file_class = YES; // Lease ID (required) string lease_id = 1; }
Informazioni aggiuntive sui contratti di locazione
Il supporto per il leasing è facoltativo. Si applica ai partner interessati all'implementazione dell'assistenza. Prima di iniziare, contatta il Centro azioni per determinare l'idoneità.
Per supportare il lease, è necessario implementare il set consigliato di API v2; inoltre,
- CreateLease deve essere implementato.
- CreateBooking deve essere implementato e dovrebbe utilizzare il riferimento del contratto di locazione. Il backend del partner effettua una prenotazione con il riferimento del contratto di noleggio fornito.
I requisiti dell'API v2 si applicano anche al supporto del leasing. Inoltre,
- CreateBooking deve utilizzare il riferimento del lease. Quando effettua una prenotazione con il riferimento del contratto di noleggio fornito, il partner consuma il contratto di noleggio e lo rende non valido per eventuali prenotazioni future. 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 un riferimento al contratto di noleggio e l'ID contratto di noleggio non è noto al partner.
