Java Sample Client

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.