Uwierzytelnianie za pomocą interfejsu Maps Booking API

Aby wprowadzać aktualizacje w czasie rzeczywistym, musisz wysyłać żądania do interfejsu Maps Booking API. Interfejs API rezerwacji w Mapach wymaga uwierzytelniania żądań za pomocą OAuth 2.0 na koncie usługi GCP, które ma dostęp do interfejsu API i ma przypisane niezbędne zasoby QPS. W tym przewodniku znajdziesz instrukcje, jak:

  1. Konfigurowanie projektu Google Cloud
  2. Tworzenie konta usługi
  3. Włączanie interfejsu Maps Booking API w projekcie GCP
  4. Debugowanie typowych problemów

Informacje o tym, jak wysyłać żądania do interfejsu API, znajdziesz w sekcji aktualizacje interfejsu API w czasie rzeczywistym w przewodniku Rezerwacje od A do Z.

Konfigurowanie projektu Google Cloud za pomocą Centrum Actions

  1. Zaloguj się na swoje konto Google Cloud Platform.
  2. Możesz utworzyć nowy projekt lub użyć istniejącego.
    • Zapisz numer projektu w chmurze, ponieważ będziesz go potrzebować w kolejnych krokach. Numer projektu w chmurze znajdziesz też na stronie głównej Google Cloud Platform. Numer projektu w chmurze jest zawsze liczbowy.
  3. Zaloguj się w Portalu Partnera.
  4. Na stronie Zadania wstępne w Portalu Partnera wykonaj krok 1, przesyłając numer projektu w chmurze i adres e-mail tego projektu (adres e-mail używany do administrowania projektem w chmurze).

Tworzenie konta usługi i danych logowania OAuth

  1. Zaloguj się ponownie na swoje konto Google Cloud Platform.
  2. Otwórz stronę Administracja & gt; Konta usługi.
  3. Wyszukaj identyfikator istniejącego lub nowo utworzonego projektu w chmurze.
  4. Utwórz konto usługi.
  5. Podaj szczegóły konta usługi.
  6. Przypisz do nowego konta usługi rolę, która najlepiej odpowiada potrzebom aplikacji. Wybór roli dla konta usługi nie będzie miał wpływu na to, jakie wywołania można wysyłać do interfejsu Google Maps Booking API, ponieważ przydzielenie wystarczającej puli do ich używania jest określane przez powiązanie numeru projektu w konfiguracji Centrum działań. Jeśli nie masz pewności, jaką rolę wybrać, wybierz Projekt > Widzący.
  7. Po kliknięciu „Dalej” w kroku 6 pojawi się opcja tworzenia kluczy JSON.
  8. Zapisz dane logowania w formacie JSON. Zapisz je w bezpiecznym miejscu, ponieważ nie będzie można ich później odzyskać.
  9. Zaloguj się ponownie w Portalu dla partnerów i wykonaj pozostałe zadania na stronie Zdania wprowadzające.

Włączanie interfejsu MapsBooking API

  1. Zaloguj się na swoje konto Google Cloud Platform.
  2. Kliknij Interfejsy API i usługi > Panel.
  3. Kliknij Włącz interfejsy API i usługi i wyszukaj Google Maps Booking API.
  4. Włącz te interfejsy API:
    • Google Maps Booking API
    • Interfejs Google Maps Booking API (dla programistów)

Najczęstsze błędy

Problemy z autoryzacją podczas wysyłania żądań aktualizacji w czasie rzeczywistym mogą wystąpić z różnych powodów. Jeśli potrzebujesz ogólnych wskazówek dotyczących przesyłania żądań aktualizacji w czasie rzeczywistym, zapoznaj się z sekcją Aktualizacje interfejsu API w czasie rzeczywistym w przewodniku kompleksowym dotyczącym rezerwacji. W sekcji Przykłady kodu znajdziesz też przykładowe klientów w różnych językach.

Jeśli napotykasz błąd 403, sprawdź, czy spełniasz wszystkie te wymagania:

  1. Użyj biblioteki klienta Google.
  2. Utwórz dane logowania OAuth za pomocą autoryzacji konta usługi.
  3. Autoryzuj odpowiednio do zakresu.
  4. Wykonuj połączenia z odpowiednim punktem końcowym (wymienionym poniżej).

Upewnij się, że wywołujesz odpowiedni punkt końcowy:

  1. Piaskownica: https://partnerdev-mapsbooking.googleapis.com/v1alpha/...
  2. Produkcja: https://mapsbooking.googleapis.com/v1alpha/...

Sprawdź, czy prawidłowo autoryzujesz żądania dotyczące danych logowania OAuth:

  1. Autoryzujesz zakres „https://www.googleapis.com/auth/mapsbooking”.
  2. Używasz klucza konta usługi utworzonego w sekcji Tworzenie konta usługi i danych logowania OAuth.

Nadal widzisz błędy?

Jeśli po wykonaniu tych czynności nadal widzisz błędy, skontaktuj się z zespołem pomocy Actions Center, podając te informacje:

  • Numer i identyfikator projektu Cloud wraz ze zrzutem ekranu
  • Identyfikator konta usługi
  • Adres e-mail użyty do utworzenia konta usługi
  • Szczegóły punktu końcowego, do którego wysyłane były żądania:
  • Czas próby wykonania żądania
  • pełne żądania i komunikaty o błędach otrzymane podczas wysyłania żądań;