Parametri di richiesta obbligatori

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

  • Il numero o l'ID del tuo progetto Google Cloud nell'intestazione X-Goog-User-Project della richiesta. Questo valore determina il progetto utilizzato per il calcolo della fatturazione e delle quote di utilizzo.

  • Un token OAuth nell'intestazione Authorization della richiesta. Per ulteriori informazioni sull'utilizzo di OAuth con l'API Maps Datasets, consulta Utilizzare OAuth.

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

  • L'ID del set di dati nell'URL della richiesta. Ogni volta che esegui un'azione su un insieme di dati specifico, devi passare l'ID del set di dati nell'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 del progetto

Per ottenere PROJECT_NUMBER_OR_ID del tuo progetto Google Cloud:

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

  2. Se richiesto, seleziona il tuo progetto.

  3. Il numero di progetto e l'ID del progetto vengono visualizzati nell'area Informazioni sul progetto della schermata della panoramica.

Ottenere un token OAuth

Per l'autenticazione, la richiesta dell'API deve contenere un token OAuth nell'Authorization. Per saperne di più, consulta l'articolo Utilizzare 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 di un comando cURL per generare un nuovo token per ogni richiesta, come mostrato nell'esempio sopra.

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