Uwierzytelnianie za pomocą interfejsu Maps Booking API

Aby wprowadzać aktualizacje w czasie rzeczywistym, musisz wysyłać żądania do interfejsu Maps Booking API. Interfejs Maps Booking API wymaga uwierzytelniania żądań za pomocą protokołu OAuth 2.0 z użyciem konta usługi GCP, które ma dostęp do interfejsu API i ma przydzieloną niezbędną liczbę zapytań na sekundę. Z tego przewodnika dowiesz się, 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 po ofertach rezerwacji.

Konfigurowanie projektu w chmurze Google w Centrum działań

Uwaga: jeśli masz już skonfigurowane konto w Portalu dla partnerów, musisz użyć projektu Google Cloud, który został wpisany w ramach konfiguracji. Jeśli nie masz już dostępu do tego projektu Google Cloud Platform lub potrzebujesz pomocy w jego identyfikacji, skontaktuj się z osobą kontaktową w Centrum działań.

1. Zaloguj się na konto Google Cloud Platform.
2. Możesz utworzyć nowy projekt lub użyć istniejącego.
   • Zanotuj numer projektu w chmurze, ponieważ będzie Ci potrzebny w następnych krokach. Numer projektu w chmurze znajdziesz też na stronie głównej Google Cloud Platform. Numer projektu w chmurze zawsze składa się tylko z cyfr.
3. Zaloguj się w Portalu dla partnerów.
4. Wykonaj krok 1 na stronie Onboarding Tasks (Zadania związane z wprowadzeniem) w Portalu dla partnerów, przesyłając numer projektu w chmurze i adres e-mail projektu w chmurze (adres e-mail używany do administrowania projektem w chmurze).

Tworzenie konta usługi i danych logowania OAuth

Uwaga: te czynności musi wykonać konto z adresem e-mail dewelopera, który został podany w krokach zadań związanych z wprowadzeniem.

1. Zaloguj się ponownie na konto Google Cloud Platform.
2. Otwórz Administracja > Konta usługi.
3. Wyszukaj istniejący lub nowo utworzony identyfikator projektu w chmurze.
4. Utwórz konto usługi.
5. Wypełnij szczegóły konta usługi.
6. Do nowego konta usługi przypisz rolę, która najlepiej odpowiada potrzebom Twojej aplikacji. Wybór roli konta usługi nie ma wpływu na to, jakie wywołania można wykonywać w interfejsie Google Maps Booking API, ponieważ przydzielenie wystarczającego limitu na ich używanie zależy od powiązania numeru projektu w konfiguracji Centrum działań. Jeśli nie masz pewności, jaką rolę wybrać, kliknij Projekt > Wyświetlający.
7. Po kliknięciu „Dalej” w kroku (6) pojawi się opcja utworzenia 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 Wprowadzenie w Portalu dla partnerów.

Włączanie interfejsu MapsBooking API

1. Zaloguj się na konto Google Cloud Platform.
2. Otwórz Interfejsy API i usługi > Panel informacyjny.
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
   • Google Maps Booking API (Dev)

Uwaga: jeśli masz już za sobą proces wprowadzania i chcesz zaktualizować istniejący projekt w chmurze na nowy, skontaktuj się z osobą odpowiedzialną za Centrum działań.

Najczęstsze błędy

Podczas wysyłania próśb o aktualizacje w czasie rzeczywistym mogą wystąpić różne problemy z autoryzacją. Ogólne wskazówki dotyczące tworzenia żądań aktualizacji w czasie rzeczywistym znajdziesz w sekcji Aktualizacje interfejsu API w czasie rzeczywistym w przewodniku po ofertach rezerwacji. Przykładowe klienty w różnych językach znajdziesz też w sekcji Przykłady kodu.

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

1. Użyj biblioteki klienta Google.
2. Utwórz dane logowania OAuth przy użyciu autoryzacji konta usługi.
3. Autoryzuj w odpowiednim zakresie.
4. Wywołaj odpowiedni punkt końcowy (wymieniony poniżej).

Upewnij się, że wywołujesz właściwy punkt końcowy:

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

Sprawdź, czy prawidłowo autoryzujesz żądania 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 osobą z zespołu Centrum działań, podając te informacje:

• Numer i identyfikator projektu w chmurze 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 próbowano wysłać żądania
• Czas prób żądania
• Pełne żądania i komunikaty o błędach otrzymywane podczas wysyłania żądań.