Client API Java Booking

Puoi scaricare i nostri Client API Java Real Time Update 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 decomprime il file per ottenere il "mapsbooking" pacchetto.

2. Crea un progetto Java nel tuo IDE e 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 tuo progetto Java nella directory src.

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

Puoi trovare ulteriori dettagli sull'API REST disponibili qui.

Risoluzione dei problemi:

1. Quando provi a creare un nuovo commerciante/servizio con un merchantId esistente oppure serviceId, riceverai 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 alla disponibilità di sostituzione con un ID commerciante non valido serviceId, la chiamata non genererà un messaggio di errore. Questo perché le modifiche agli slot di disponibilità tramite le RTU supportano l'esecuzione fuori ordine e pertanto non è associato a un merchantId o a un serviceId. Tuttavia, gli slot della richiesta non verranno pubblicate in produzione a causa di valori non validi merchantId o serviceId. Per rendere le aree pubblicabili, aggiungi la macro commerciante o servizio mancante tramite RTU o feed.
3. In tutte le funzioni di aggiornamento, il parametro "updateMask" deve essere in FieldMask per specificare i campi da aggiornare. L'API è necessario modificare solo i valori dei campi come specificato nella maschera e lasciare invariati gli altri. Se passi la stringa updateMask sbagliata, l'aggiornamento non avrà effetto. Se una maschera dei campi non è presente al momento dell'aggiornamento, l'operazione si applica a tutti i campi (come se una maschera di tutti i campi avesse specificato). Quindi, se vuoi aggiornare tutti i campi, imposta il Maschera di aggiornamento vuota.
4. Qualsiasi campo con valore zero non viene mostrato nella risposta.