Client API Java Booking

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

Prerequisito:

Dopo aver creato 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 nell'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 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 (inclusi i file jar nella directory mapsbooking e libs-sources).
  5. In entrambi i file Java, segui i TODO 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 merchantId 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 disponibilità per la sostituzione con un commerciante o un ID servizio non valido, la chiamata non mostrerà un messaggio di errore. Questo perché le modifiche agli slot di disponibilità tramite le RTU supportano l'esecuzione fuori ordine e pertanto non sono associate a un commerciante o un ID servizio. Tuttavia, le aree annuncio nella richiesta non saranno pubblicate in produzione a causa dell'ID commerciante o dell'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 in formato FieldMask per specificare i campi da aggiornare. L'API è necessaria solo per modificare i valori dei campi specificati nella maschera e lasciare gli altri intatti. Se trasmetti la stringa updateMask errata, l'aggiornamento non avrà effetto. Se una maschera di campo non è presente nell'aggiornamento, l'operazione si applica a tutti i campi (come se è stata specificata una maschera di campo di tutti i campi). Quindi, se vuoi aggiornare tutti i campi, è sufficiente impostare updateMask vuoto.
  4. Qualsiasi campo con valore zero non viene mostrato nella risposta.