Klient interfejsu Java Booking API

Aby rozpocząć wdrażanie aktualizacji w czasie rzeczywistym, możesz pobrać nasz klient interfejsu API aktualizacji w czasie Java.

Warunek wstępny:

Po utworzeniu konta usługi pobierz klucz prywatny.

Wypróbuj:

  1. Pobierz bibliotekę klienta Java, aby rozpakować plik, aby uzyskać pakiet „mapsbooking”.

  2. Utwórz w IDE swój projekt w języku Java, pobierz przykładowe kody InventoryUpdate.java i BookingNotification.java z tego repozytorium:

    git clone https://maps-booking.googlesource.com/java-maps-booking-api-example

    i zaimportuj je do projektu w języku Java w katalogu src.

  3. Utwórz kopię klucza prywatnego (plik JSON) w katalogu src.
  4. Dodaj bibliotekę klienta w języku Java do zależności od projektu (uwzględnij pliki jar w katalogu mapsbooking i libs-sources).
  5. Aby dokończyć implementowanie plików Java, postępuj zgodnie z instrukcjami

Więcej informacji na temat interfejsu API REST znajdziesz tutaj.

Rozwiązywanie problemów:

  1. Podczas próby utworzenia nowego sprzedawcy/usługi z istniejącym identyfikatorem sprzedawcy lub usługi pojawi się następujący komunikat o błędzie:

    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. W przypadku zastąpienia dostępności z nieprawidłowym identyfikatorem sprzedawcy lub serviceId nie zostanie wyświetlony komunikat o błędzie. Dzieje się tak, ponieważ zmiany w przedziałach dostępności przez RTU obsługują wykonanie w złej kolejności i nie są powiązane z identyfikatorem sprzedawcy lub usługi. Przedziały w żądaniu nie będą jednak wyświetlane w środowisku produkcyjnym z powodu nieprawidłowego identyfikatora lub identyfikatora sprzedawcy. Aby umożliwić obsługę przedziałów, dodaj brakującego sprzedawcę lub usługę za pomocą RTU lub plików danych.
  3. We wszystkich funkcjach aktualizacji parametr „updateMask” musi mieć format FieldMask (Maska pola), aby można było określać pola do zaktualizowania. Interfejs API jest wymagany tylko do zmiany wartości pól określonych w masce i nie powoduje zmian w pozostałych polach. Jeśli przekazujesz nieprawidłowy ciąg znaków updateMask, aktualizacja nie będzie obowiązywać. Jeśli podczas aktualizacji nie ma maski pola, operacja ma wpływ na wszystkie pola (tak jakby maska wszystkich pól była określona). Jeśli chcesz zaktualizować wszystkie pola, ustaw pustą wartość updateMask.
  4. Żadne pole z wartością zero nie jest wyświetlane w odpowiedzi.