Client Java dell'API Booking

Puoi scaricare il nostro client Java per l'API di aggiornamento in tempo reale per iniziare a implementare gli aggiornamenti in tempo reale.

Prerequisito:

Crea l'account di servizio e scarica la chiave privata.

Per iniziare:

  1. Scarica la libreria client Java, decomprimi il file per ottenere il pacchetto "mapsbooking".
  2. Crea un progetto Java nel tuo IDE, scarica i codici di esempio InventoryUpdate.java e BookingNotification.java da questo repository:

    git clone https://maps-booking.googlesource.com/java-maps-booking-api-example

    e importarli nel progetto Java nella directory src.

  3. Crea una copia della chiave privata (file JSON) nella directory src.
  4. Aggiungi la libreria client Java alle dipendenze del progetto (include i file JAR nella directory mapsbooking e libs-sources).
  5. In entrambi i file Java, segui le istruzioni TO DO per completare le implementazioni

Puoi trovare ulteriori dettagli sull'API REST qui.

Risoluzione dei problemi:

  1. Quando provi a creare un nuovo commerciante/servizio con un merchantId o serviceId esistente, viene visualizzato il seguente messaggio di errore:

    409 Conflict
    {
      code : 409,
      errors :
        [{
            domain : global,
            message : Requested entity already exists,
            reason : alreadyExists,
            debugInfo : detail: "[ORIGINAL ERROR] generic::already_exists: ...”\n"
        }],
      message : Requested entity already exists,
      status : ALREADY_EXISTS
    }
  2. Quando effettui una chiamata di sostituzione della disponibilità con un merchantId o un serviceId non valido, la chiamata non genera un messaggio di errore. Questo perché le modifiche agli slot di disponibilità tramite gli RTU supportano l'esecuzione fuori sequenza e pertanto non sono associate a un merchantId o a un serviceId. Tuttavia, gli slot nella richiesta non verranno pubblicati in produzione a causa di merchantId o serviceId invalidi. Per rendere disponibili gli slot, aggiungi il commerciante o il servizio mancante tramite RTU o feed.
  3. In tutte le funzioni di aggiornamento, il parametro "updateMask" deve essere in formato FieldMask per specificare i campi da aggiornare. L'API è obbligatoria per modificare solo i valori dei campi come specificato nella maschera e lasciare invariati gli altri. Se passi la stringa updateMask errata, l'aggiornamento non verrà applicato. Se non è presente una maschera di campi durante l'aggiornamento, l'operazione si applica a tutti i campi (come se fosse stata specificata una maschera di campi per tutti i campi). Pertanto, se vuoi aggiornare tutti i campi, imposta updateMask su vuoto.
  4. Qualsiasi campo con un valore pari a zero non viene mostrato nella risposta.