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:
- Scarica la libreria client Java, decomprimi il file per ottenere il pacchetto "mapsbooking".
-
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.
- Crea una copia della chiave privata (file JSON) nella directory src.
- Aggiungi la libreria client Java alle dipendenze del progetto (include i file JAR nella directory mapsbooking e libs-sources).
- 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:
-
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” }
- 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.
- 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.
- Qualsiasi campo con un valore pari a zero non viene mostrato nella risposta.