OAuth verwenden

Die Map Management API unterstützt die Verwendung von OAuth 2.0 für die Authentifizierung. Google unterstützt gängige OAuth 2.0-Szenarien, z. B. für einen Webserver.

In diesem Dokument wird beschrieben, wie Sie ein OAuth-Token an den Map Management API-Aufruf in Ihrer Entwicklungsumgebung übergeben. Eine Anleitung zur Verwendung von OAuth in einer Produktionsumgebung finden Sie unter Authentifizierung bei Google.

Hinweis

Um die Map Management API nutzen zu können, benötigen Sie ein Projekt mit einem Rechnungskonto. Außerdem muss die Map Management API aktiviert sein. Weitere Informationen finden Sie unter Einrichtung in der Cloud Console.

Informationen zu OAuth

Je nach Bereitstellungsumgebung können Sie Zugriffstokens mit OAuth auf verschiedene Arten erstellen und verwalten.

Das Google OAuth 2.0-System unterstützt beispielsweise Interaktionen zwischen Servern, z. B. zwischen Ihrer Anwendung und einem Google-Dienst. Für dieses Szenario benötigen Sie ein Dienstkonto. Dieses Konto gehört Ihrer Anwendung und nicht einem bestimmten Nutzer. Ihre Anwendung ruft im Namen des Dienstkontos Google APIs auf, da Nutzer nicht direkt beteiligt sind. Weitere Informationen zu Authentifizierungsmethoden finden Sie unter Authentifizierung bei Google.

Alternativ können Sie die Map Management API als Teil einer Android- oder iOS-App verwenden. Weitere Informationen zur Verwendung von OAuth mit der Map Management API, einschließlich Informationen zur Verwaltung von Zugriffstokens für verschiedene Bereitstellungsumgebungen, finden Sie unter OAuth 2.0 für den Zugriff auf Google APIs verwenden.

Informationen zu OAuth-Bereichen

Wenn Sie OAuth mit der Map Management API verwenden möchten, muss das OAuth-Token den Bereich https://www.googleapis.com/auth/cloud-platform haben.

REST API-Aufrufe in Ihrer lokalen Entwicklungsumgebung testen

Wenn Sie die Map Management API mit einem OAuth-Token ausprobieren möchten, aber keine Umgebung zum Generieren von Tokens eingerichtet haben, können Sie den Aufruf mit dem Verfahren in diesem Abschnitt ausführen.

In diesem Beispiel wird beschrieben, wie Sie den Aufruf mit dem OAuth-Token ausführen, das von den Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) bereitgestellt wird. Weitere Informationen zur Verwendung von ADC zum Aufrufen von Google APIs mit Clientbibliotheken finden Sie unter Mit Clientbibliotheken authentifizieren.

Vorbereitung

Bevor Sie eine REST-Anfrage mit ADC stellen können, müssen Sie die Google Cloud CLI verwenden, um Anmeldedaten für ADC bereitzustellen:

  1. Falls noch nicht geschehen, erstellen Sie ein Projekt und aktivieren Sie die Abrechnung. Folgen Sie dazu der Anleitung unter In der Cloud Console einrichten.
  2. Installieren und initialisieren Sie die gcloud CLI.

  3. Führen Sie auf Ihrem lokalen Computer den Befehl gcloud aus, um die Datei mit den Anmeldedaten zu erstellen:

    gcloud auth application-default login
  4. Melden Sie sich an, wenn Sie dazu aufgefordert werden. Nach der Anmeldung werden Ihre Anmeldedaten in der lokalen Anmeldedatendatei für ADC gespeichert.

Weitere Informationen finden Sie im Abschnitt Lokale Entwicklungsumgebung der Dokumentation Anmeldedaten für Standardanmeldedaten für Anwendungen bereitstellen.

REST-Anfrage stellen

In diesem Beispiel übergeben Sie zwei Anfrageheader:

  • Übergeben Sie das OAuth-Token im Authorization-Header. Verwenden Sie dazu den folgenden Befehl, um das Token zu generieren:

    gcloud auth application-default print-access-token

    Das zurückgegebene Token hat den Bereich https://www.googleapis.com/auth/cloud-platform.

  • Übergeben Sie die ID oder den Namen Ihres Google Cloud-Projekts, für das die Abrechnung aktiviert ist, im Header X-Goog-User-Project. Weitere Informationen finden Sie unter Cloud Console einrichten.

Rufen Sie die Map Management API mit einem OAuth-Token auf:

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/

Fehlerbehebung

Wenn Ihre Anfrage eine Fehlermeldung zurückgibt, die angibt, dass Nutzeranmeldedaten von dieser API nicht unterstützt werden, lesen Sie den Abschnitt Nutzeranmeldedaten funktionieren nicht.