Un Lease detiene temporaneamente la proprietà di uno slot richiesto.
Il backend del partner verifica che lo spazio per appuntamenti richiesto sia valido e ancora disponibile. Internamente, il partner crea una trattenuta temporanea per lo slot richiesto, impostata per scadere automaticamente il giorno 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 assistenza facoltativa per il Lease. Con il supporto per il lease, la creazione di un lease per lo slot richiesto è il primo passaggio quando si crea 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;
}
Informazioni aggiuntive sui lease
L'assistenza per il lease è facoltativa. Si applica ai partner interessati a implementare l'assistenza. Contatta il Centro azioni per verificarne l'idoneità prima di iniziare.
Per supportare il lease, è necessario implementare l'insieme consigliato di API v2;
- CreateLease deve essere implementato.
- CreateBooking deve essere implementato e dovrebbe utilizzare il riferimento di lease. Il backend del partner effettua una prenotazione con il riferimento di locazione fornito.
I requisiti dell'API v2 si applicano anche al supporto per il lease; inoltre,
- CreateBooking dovrebbe utilizzare un riferimento lease. Quando effettui una prenotazione con il riferimento di locazione fornito, il partner utilizza il contratto di locazione e lo rende non valido per eventuali ulteriori prenotazioni. Il partner è anche 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 di lease e l'ID lease è sconosciuto al partner.
