Interfejs Map Management API obsługuje uwierzytelnianie za pomocą protokołu OAuth 2.0. Google obsługuje typowe scenariusze OAuth 2.0, np. dotyczące serwera WWW.
Z tego dokumentu dowiesz się, jak przekazać token OAuth do wywołania interfejsu Map Management API w środowisku programistycznym. Instrukcje korzystania z protokołu OAuth w środowisku produkcyjnym znajdziesz w artykule Uwierzytelnianie w Google.
Zanim zaczniesz
Zanim zaczniesz korzystać z interfejsu Map Management API, musisz mieć projekt z kontem rozliczeniowym i włączonym interfejsem Map Management API. Więcej informacji znajdziesz w artykule o konfigurowaniu w konsoli Cloud.
Informacje o protokole OAuth
Tokeny dostępu możesz tworzyć i zarządzać nimi za pomocą protokołu OAuth na kilka sposobów, w zależności od środowiska wdrażania.
Na przykład system Google OAuth 2.0 obsługuje interakcje między serwerami, takie jak te między Twoją aplikacją a usługą Google. W tym scenariuszu potrzebujesz konta usługi. To konto należy do Twojej aplikacji, a nie do użytkownika. Aplikacja wywołuje interfejsy API Google w imieniu konta usługi, ponieważ użytkownicy nie są bezpośrednio zaangażowani. Więcej informacji o metodach uwierzytelniania znajdziesz w artykule Uwierzytelnianie w Google.
Możesz też używać interfejsu Map Management API w aplikacji mobilnej na Androida lub iOS. Więcej informacji o używaniu protokołu OAuth z interfejsem Map Management API, w tym o zarządzaniu tokenami dostępu w różnych środowiskach wdrażania, znajdziesz w artykule Używanie OAuth 2.0 do korzystania z interfejsów API Google.
Informacje o zakresach OAuth
Aby używać protokołu OAuth z interfejsem Map Management API, token OAuth musi mieć zakres https://www.googleapis.com/auth/cloud-platform.
Wypróbuj wywołania interfejsu API REST w lokalnym środowisku programistycznym
Jeśli chcesz wypróbować interfejs API zarządzania Google Analytics za pomocą protokołu OAuth, ale nie masz skonfigurowanego środowiska do generowania tokenów, możesz wykonać wywołanie, korzystając z procedury opisanej w tej sekcji.
Ten przykład pokazuje, jak użyć tokena OAuth dostarczonego przez domyślne uwierzytelnianie aplikacji (ADC) do wykonania wywołania. Więcej informacji o używaniu ADC do wywoływania interfejsów API Google za pomocą bibliotek klienta znajdziesz w artykule Uwierzytelnianie za pomocą bibliotek klienta.
Wymagania wstępne
Zanim wyślesz żądanie REST za pomocą ADC, użyj Google Cloud CLI, aby podać dane uwierzytelniające do ADC:
- Jeśli nie masz jeszcze projektu, utwórz go i włącz płatności, wykonując czynności opisane w artykule Konfigurowanie w konsoli Cloud.
- Zainstaluj i zainicjuj gcloud CLI.
Aby utworzyć plik danych uwierzytelniających, uruchom na komputerze lokalnym polecenie
gcloud:gcloud auth application-default login
- Gdy pojawi się taka prośba, zaloguj się. Po zalogowaniu się dane logowania są przechowywane w lokalnym pliku danych logowania używanym przez ADC.
Więcej informacji znajdziesz w sekcji Lokalne środowisko programistyczne w dokumentacji Podawanie danych logowania na potrzeby domyślnego uwierzytelniania aplikacji.
Wysyłanie żądania REST
W tym przykładzie przekazujesz 2 nagłówki żądania:
Przekaż token OAuth w nagłówku
Authorization, używając tego polecenia do wygenerowania tokena:gcloud auth application-default print-access-tokenZwrócony token ma zakres
https://www.googleapis.com/auth/cloud-platform.- Przekaż identyfikator lub nazwę projektu w chmurze Google z włączonymi rozliczeniami w nagłówku
X-Goog-User-Project. Więcej informacji znajdziesz w artykule o konfigurowaniu w konsoli Cloud.
Wywołaj interfejs Map Management API za pomocą tokena OAuth:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "X-Goog-User-Project: PROJECT_ID" \ https://mapmanagement.googleapis.com/v2beta/projects/PROJECT_NUMBER_OR_ID/mapConfigs/
Rozwiązywanie problemów
Jeśli Twoje żądanie zwróci komunikat o błędzie informujący, że dane logowania użytkownika nie są obsługiwane przez ten interfejs API, zapoznaj się z artykułem Dane logowania użytkownika nie działają.