Klient interfejsu Java Booking API

Plik do pobrania Klient interfejsu API aktualizacji w czasie rzeczywistym w języku Java, który ułatwia rozpoczęcie implementacji i aktualizacje w czasie rzeczywistym.

Warunek wstępny:

Poproś o utworzenie konta usługi i pobierz klucz prywatny.

Wypróbuj:

  1. Pobierz Biblioteka klienta Java rozpakuj plik, by uzyskać dostęp do rezerwacji map. pakietu SDK.
  2. Utwórz w swoim IDE projekt 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 katalogu src w projekcie Java.

  3. Utwórz kopię klucza prywatnego (pliku JSON) w katalogu src.
  4. Dodaj bibliotekę klienta Java do zależności projektu (uwzględnij pliki jar w katalogu mapsbooking i libs-sources).
  5. Aby dokończyć implementacje, w obu plikach Java postępuj zgodnie z instrukcją TODO

Więcej informacji o interfejsie API REST: znajduje się tutaj.

Rozwiązywanie problemów:

  1. Jeśli próbujesz utworzyć nowego sprzedawcę lub nową usługę z istniejącym identyfikatorem merchantId lub ServiceId 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 wywołania zastąpienia dostępności za pomocą nieprawidłowego pola merchantId lub serviceId, wywołanie nie wygeneruje komunikatu o błędzie. Dzieje się tak, ponieważ zmiany przedziałów dostępności przez RTU obsługują wykonywanie poza kolejnością nie jest więc powiązany z identyfikatorem merchantId ani parametrem serviceId. Przedziały te z żądania nie zostanie przesłany w wersji produkcyjnej z powodu nieprawidłowego merchantId lub serviceId. Aby umożliwić wyświetlanie przedziałów, dodaj komponent brak sprzedawcy lub usługi w RTU lub plikach danych.
  3. We wszystkich funkcjach aktualizacji parametr „updateMask” musi być w Format FieldMask, aby określić pola do zaktualizowania. Interfejs API jest wymagane do zmiany tylko wartości pól określonych w masce a pozostałych bez zmian. Jeśli przekażesz nieprawidłowy ciąg updateMask, aktualizacja nie będzie miała zastosowania. Jeśli podczas aktualizacji nie ma maski pola, operacja ma zastosowanie do wszystkich pól (jak gdyby maska wszystkich pól wykorzystywała ). Jeśli więc chcesz zaktualizować wszystkie pola, ustaw wartość Pole updateMask jest puste.
  4. Pole z wartością zerową nie wyświetla się w odpowiedzi.