Erforderliche Anfrageparameter

Für jede Anfrage an die Maps Datasets API müssen Sie Folgendes angeben:

• Die Nummer oder ID Ihres Google Cloud-Projekts im Header X-Goog-User-Project der Anfrage. Dieser Wert bestimmt das Projekt, das für die Abrechnung und die Berechnung des Nutzungskontingents verwendet wird.

  Hinweis: Wenn Sie ein Dienstkonto für die Authentifizierung verwenden, können Sie den Header X-Goog-User-Project weglassen. Weitere Informationen zu Dienstkonten finden Sie unter Authentifizierung bei Google.

• Ein OAuth-Token im Header Authorization der Anfrage. Weitere Informationen zur Verwendung von OAuth mit der Maps Datasets API finden Sie unter OAuth verwenden.

• Eine Google Cloud-Projektnummer oder ‑ID in der Anfrage-URL. Dieser Wert gibt das Projekt an, das das Dataset enthält. Dieses Projekt ist in der Regel dasselbe wie das im Header X-Goog-User-Project angegebene Projekt, muss aber nicht identisch sein.

• Die Dataset-ID in der Anfrage-URL. Wenn Sie eine Aktion für ein bestimmtes Dataset ausführen, übergeben Sie die ID des Datasets als Teil der Anfrage-URL.

Hinweis: Für einige Anfragen sind zusätzliche Parameter erforderlich, die in der Dokumentation zu diesen Anfragen beschrieben werden.

Beispiel: So löschen Sie ein Dataset:

curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

Projektnummer abrufen

So rufen Sie die PROJECT_NUMBER_OR_ID Ihres Google Cloud-Projekts ab:

1. Rufen Sie in der Cloud Console die Übersichtsseite des Projekts auf.

2. Wählen Sie bei Aufforderung Ihr Projekt aus.

3. Die Projektnummer und Projekt-ID werden im Bereich Projektinformationen der Übersichtsseite angezeigt.

OAuth-Token abrufen

Hinweis: Die folgende Anleitung zum Generieren eines OAuth-Tokens ist nicht für die Verwendung in einer Produktionsumgebung vorgesehen. Verwenden Sie diese Anleitung nur für eine Entwicklungs- oder Testumgebung.

Für die Authentifizierung muss Ihre API-Anfrage ein OAuth-Token im Header Authorization enthalten. Weitere Informationen finden Sie unter OAuth verwenden.

Verwenden Sie beispielsweise den folgenden gcloud-Befehl, um das Token zu generieren:

gcloud auth application-default print-access-token

Sie können den gcloud-Befehl direkt in den Header Authorization in einem cURL-Befehl einfügen, um bei jeder Anfrage ein neues Token zu generieren, wie im obigen Beispiel gezeigt.

Alternativ können Sie eine Umgebungsvariable festlegen, die das Token enthält, und die Umgebungsvariable dann als Teil der Anfrage übergeben:

export TOKEN=$(gcloud auth application-default print-access-token)
curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $TOKEN" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID