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 i calcoli delle quote di fatturazione e di utilizzo.Un token OAuth nell'intestazione
Authorization
della richiesta. Per saperne di più sull'utilizzo di OAuth con l'API Maps Datasets, consulta Utilizzare OAuth.Un numero o ID di progetto Google Cloud nell'URL della richiesta. Questo valore specifica il progetto contenente il set di dati. Sebbene questo progetto di solito sia uguale al progetto specificato nell'intestazione
X-Goog-User-Project
, non è necessario che lo sia.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 del progetto
Per ottenere l'PROJECT_NUMBER_OR_ID del tuo progetto Google Cloud:
Vai alla pagina Panoramica del progetto nella console Cloud.
Se richiesto, seleziona il tuo progetto.
Il Numero di progetto e l'ID progetto vengono visualizzati nell'area Informazioni sul progetto della schermata Panoramica.
Ottenere un token OAuth
Per l'autenticazione, la richiesta API deve contenere un token OAuth nell'intestazione Authorization
. Per ulteriori informazioni, consulta l'articolo su come 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 precedente.
In alternativa, puoi impostare una variabile di ambiente contenente il token e poi passare la variabile di ambiente 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