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. Mit diesem Wert wird das Projekt festgelegt, das für die Abrechnung und Berechnung des Nutzungskontingents verwendet wird.

  • Ein OAuth-Token im Authorization-Header 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 mit dem in der X-Goog-User-Project-Überschrift angegebenen Projekt identisch, muss es aber nicht sein.

  • Die Dataset-ID in der Anfrage-URL. Wenn Sie eine Aktion auf einem bestimmten Datensatz ausführen, geben Sie die ID des Datensatzes als Teil der Anfrage-URL an.

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. Rufen Sie in der Cloud Console die Übersichtsseite des Projekts auf.

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

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

OAuth-Token abrufen

Für die Authentifizierung muss Ihre API-Anfrage ein OAuth-Token im Authorization-Header 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 Befehl gcloud direkt in den Authorization-Header in einem cURL-Befehl einfügen, um bei jeder Anfrage ein neues Token zu generieren, wie im Beispiel oben gezeigt.

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