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 X-Goog-User-Project-Header der Anfrage. Dieser Wert bestimmt die Projekt, das zur Abrechnung und zur Berechnung von Nutzungskontingenten verwendet wird.

  • Ein OAuth-Token im Authorization-Header der Anfrage. Weitere Informationen 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. Während dieses Projekt in der Regel mit dem im X-Goog-User-Project-Header angegebenen Projekt identisch, muss nicht identisch sein.

  • Die Dataset-ID in der Anfrage-URL. Immer wenn Sie eine Aktion für ein spezifischen Dataset übergeben wird, übergeben Sie die ID des Datasets als Teil der Anfrage-URL.

So löschen Sie beispielsweise 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. Gehen Sie zur Übersichtsseite in der Cloud Console.

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

  3. Die Projektnummer und die Projekt-ID werden im Bereich Projektinformationen des Übersichtsbildschirms angezeigt.

OAuth-Token abrufen

Zur Authentifizierung muss Ihre API-Anfrage ein OAuth-Token in der Authorization-Header. 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 Befehl gcloud direkt in den Authorization-Header einer cURL-Befehl zum Generieren eines neuen Tokens bei jeder Anfrage, wie im Beispiel gezeigt oben.

Alternativ können Sie eine Umgebungsvariable festlegen, die das Token enthält und dann die Umgebungsvariable 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