REST JAVA

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

Prerequisito:

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

Per iniziare:

  1. Scarica la libreria client Java per decomprimere 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 tua chiave privata (file JSON) nella directory src.
  4. Aggiungi la libreria client Java alle dipendenze del tuo progetto (includi i file jar nelle directory Mapsbooking e libs-sources).
  5. In entrambi i file Java, segui le istruzioni per completare le implementazioni

Ulteriori dettagli sull'API REST sono disponibili qui.

Risoluzione dei problemi:

  1. Quando provi a creare un nuovo commerciante/servizio con un ID commerciante o ServiceId esistente, 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 di sostituzione della disponibilità con un ID commerciante o serviceId non valido, la chiamata non genererà un messaggio di errore. Questo perché le modifiche agli slot di disponibilità tramite RTU supportano l'esecuzione fuori ordine e, pertanto, non sono associate a un ID commerciante o un ID servizio. Tuttavia, gli slot nella richiesta non verranno pubblicati nella produzione a causa di un ID commerciante o un ID servizio non valido. Per rendere gli slot pubblicabili, aggiungi il commerciante o il servizio mancante tramite RTU o feed.
  3. In tutte le funzioni di aggiornamento, il parametro "updateMask" deve essere nel formato FieldMask per specificare i campi da aggiornare. L'API deve modificare solo i valori dei campi specificati nella maschera e lasciare invariati gli altri. Se passi la stringa updateMask errata, l'aggiornamento non verrà applicato. Se una maschera di campo non è presente al momento dell'aggiornamento, l'operazione si applica a tutti i campi (come se fosse stata specificata una maschera per tutti i campi). Pertanto, se vuoi aggiornare tutti i campi, devi semplicemente impostare il campo updateMask vuoto.
  4. I campi con valore zero non vengono visualizzati nella risposta.