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 przy użyciu konta usługi GCP, które ma dostęp do interfejsu API i przydzielono mu niezbędne zapytania na sekundę. Ten przewodnik pomoże Ci:
- Konfigurowanie projektu Google Cloud
- Tworzenie konta usługi
- Włączanie interfejsu Maps Booking API w projekcie GCP
- Debugowanie częstych problemów
Informacje na temat wysyłania żądań do interfejsu API znajdziesz w sekcji Aktualizacje interfejsu API w czasie rzeczywistym w przewodniku po rezerwacjach.
Konfigurowanie projektu Google Cloud w Actions Center
- Zaloguj się na konto Google Cloud Platform.
- Do tego celu możesz utworzyć nowy projekt lub użyć już istniejącego.
- Zapisz numer projektu w chmurze, ponieważ będziesz go potrzebować w kolejnych krokach. Numer projektu w chmurze możesz też znaleźć na stronie głównej Google Cloud Platform. Numer projektu w chmurze jest zawsze liczbowy.
- Zapisz numer projektu w chmurze, ponieważ będziesz go potrzebować w kolejnych krokach. Numer projektu w chmurze możesz też znaleźć na stronie głównej Google Cloud Platform. Numer projektu w chmurze jest zawsze liczbowy.
- Zaloguj się w portalu dla partnerów.
- Wykonaj krok 1 na stronie Zadania wprowadzające w portalu dla partnerów, podając numer projektu Cloud oraz adres e-mail tego projektu (adres e-mail używany do administrowania projektem w chmurze).
Tworzę konto usługi i dane logowania OAuth
- Ponownie zaloguj się na konto Google Cloud Platform.
- Kliknij Administracja > Konta usługi.
- Wyszukaj identyfikator istniejącego lub nowo utworzonego projektu w chmurze.
- Utwórz konto usługi.
- Wypełnij szczegóły konta usługi.
- Przypisz nowemu kontu usługi rolę najbardziej odpowiednią do potrzeb Twojej aplikacji. Wybór roli dla konta usługi nie ma wpływu na to, jakie wywołania można wykonywać w interfejsie Google Maps Booking API, ponieważ przydzielanie wystarczającego limitu do korzystania z niego jest określane przez powiązanie numeru projektu w konfiguracji Centrum działań. Jeśli nie wiesz, którą rolę wybrać, wybierz Projekt > Przeglądający.
- Po kliknięciu „Dalej” w kroku (6) zobaczysz opcję tworzenia kluczy JSON.
- Zapisz dane logowania JSON. Przechowuj je w bezpiecznym miejscu, bo nie będzie można ich później odzyskać.
- Zaloguj się ponownie w portalu dla partnerów i wykonaj pozostałe zadania na stronie Zadania wprowadzające w tym portalu.
Włącz interfejs API MapsBooking
- Zaloguj się na konto Google Cloud Platform.
- Kliknij Interfejsy API i usługi > Panel.
- Kliknij Włącz interfejsy API i usługi, a następnie wyszukaj
Google Maps Booking API.
- Włącz te interfejsy API:
- Google Maps Booking API
- Google Maps Booking API (w wersji deweloperskiej)
Najczęstsze błędy
Podczas wysyłania żądań aktualizacji w czasie rzeczywistym mogą występować problemy z autoryzacją. Ogólne wskazówki dotyczące wysyłania żądań aktualizacji w czasie rzeczywistym znajdziesz w sekcji poświęconej aktualizacjom interfejsu API w czasie rzeczywistym w przewodniku po rezerwacjach. Przykładowe klienty w wielu językach znajdziesz w sekcji Przykłady kodu.
Jeśli wystąpią błędy 403, sprawdź, czy spełniasz wszystkie te wymagania:
- Użyj biblioteki klienta Google.
- Utwórz dane logowania OAuth przy użyciu uwierzytelniania konta usługi.
- autoryzować w odpowiednim zakresie;
- Wyślij wywołania do odpowiedniego punktu końcowego (wymienionego poniżej).
Upewnij się, że wywołujesz wywołania do właściwego punktu końcowego:
- Piaskownica:
https://partnerdev-mapsbooking.googleapis.com/v1alpha/... - Produkcja:
https://mapsbooking.googleapis.com/v1alpha/...
Sprawdź, czy prawidłowo autoryzujesz żądania danych logowania OAuth:
- Autoryzujesz się w zakresie „https://www.googleapis.com/auth/mapsbooking”.
- Używasz klucza konta usługi utworzonego na stronie Tworzenie konta usługi i danych logowania OAuth.
Błędy nadal występują?
Jeśli po wykonaniu tych czynności nadal widzisz błędy, skontaktuj się ze swoją osobą kontaktową w Centrum działań i podaj te informacje:
- Numer projektu Cloud i identyfikator projektu ze zrzutem ekranu
- Identyfikator konta usługi
- Adres e-mail użyty do utworzenia konta usługi
- Szczegóły punktu końcowego, które próbowały wysłać żądania do
- Czas żądań żądania
- Pełne żądania i komunikaty o błędach podczas przesyłania żądań.