Specifica per l'affitto

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 disponibili. Internamente, il partner crea una trattenuta temporanea per Slot richiesto, che è impostato per scadere automaticamente lease_expiration_time. Il backend è autorizzato a modificare lease_expiration_time, ad es. se il tempo di leasing richiesto è troppo lungo. Il lease creato viene restituito al client.

La nostra API di prenotazione fornisce assistenza facoltativa per il leasing. Con il supporto del leasing, la creazione di un lease per lo slot richiesto è il primo passaggio 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 leasing

Il supporto per il leasing è facoltativo. Si applica ai partner interessati a a implementare l'assistenza. Contatta il Centro azioni per determinare l'idoneità prima di iniziare.

Per supportare il lease, è necessario implementare l'insieme consigliato di API v2. nel addizioni,

  • CreateLease è da implementare.
  • CreateBooking è per l'implementazione e che usi il riferimento di leasing. Contatto speciale effettua una prenotazione con il riferimento di leasing fornito.

I requisiti dell'API v2 si applicano anche al supporto del leasing. Inoltre,

  • CreateBooking è che userà il riferimento di leasing. Quando effettui una prenotazione con riferimento al leasing, il partner utilizza il lease e lo rende non valido per ulteriori prenotazioni. Il Partner è anche responsabile della verifica del tramite lo slot del messaggio di richiesta.
  • Come codice di errore gRPC aggiuntivo, NOT_FOUND viene utilizzato se viene fornito il riferimento lease e l'ID di leasing non è noto al partner.
di Gemini Advanced.
Figura: creazione di una prenotazione per un leasing