Parametri di richiesta obbligatori

Per effettuare una richiesta all'API Maps Datasets, devi includere:

  • Il numero o l'ID del tuo progetto cloud Google nell'intestazione X-Goog-User-Project della richiesta. Questo valore determina il progetto utilizzato per i calcoli della quota di utilizzo e di fatturazione.

  • Un token OAuth nell'intestazione Authorization della richiesta. Per saperne di più sull'utilizzo di OAuth con l'API Maps Datasets, consulta Utilizza OAuth.

  • Un numero o un ID progetto Google Cloud nell'URL della richiesta. Questo valore specifica il progetto contenente il set di dati. Sebbene questo progetto sia in genere lo stesso specificato nell'intestazione X-Goog-User-Project, non è necessario che sia lo stesso.

  • L'ID del set di dati nell'URL della richiesta. Ogni volta che esegui un'azione su un set di dati specifico, passi l'ID del set di dati come parte dell'URL della richiesta.

Ad esempio, per eliminare un set di dati:

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

Recupera il numero di progetto

Per ottenere il PROJECT_NUMBER_OR_ID del tuo progetto Google Cloud:

  1. Vai alla pagina Panoramica del progetto nella console Cloud.

  2. Se richiesto, seleziona il progetto.

  3. Il Numero progetto e l'ID progetto vengono visualizzati nell'area Informazioni sul progetto della schermata Panoramica.

Ottieni un token OAuth

Per l'autenticazione, la richiesta API deve contenere un token OAuth nell'intestazione Authorization. Per saperne di più, consulta Utilizza OAuth.

Ad esempio, utilizza il seguente comando gcloud per generare il token:

gcloud auth application-default print-access-token

Puoi includere il comando gcloud direttamente nell'intestazione Authorization in un comando cURL per generare un nuovo token a ogni richiesta, come mostrato nell'esempio precedente.

In alternativa, puoi impostare una variabile di ambiente contenente il token e poi passarla come parte della richiesta:

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