JAVA REST

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.