Parámetros de solicitud obligatorios

Para realizar cualquier solicitud a la API de Maps Datasets, debes incluir lo siguiente:

  • El número o ID de tu proyecto de Google Cloud en el encabezado X-Goog-User-Project de la solicitud Este valor determina el proyecto que se usa para calcular la cuota de facturación y uso.

  • Un token de OAuth en el encabezado Authorization de la solicitud Para obtener más información sobre el uso de OAuth con la API de Maps Datasets, consulta Cómo usar OAuth.

  • Un número o ID de proyecto de Google Cloud en la URL de la solicitud Este valor especifica el proyecto que contiene el conjunto de datos. Si bien este proyecto suele ser el mismo que el que se especifica en el encabezado X-Goog-User-Project, no es necesario que sea el mismo.

  • El ID del conjunto de datos en la URL de la solicitud. Cada vez que realices una acción en un conjunto de datos específico, debes pasar el ID del conjunto de datos como parte de la URL de la solicitud.

Por ejemplo, para borrar un conjunto de datos:

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

Obtén el número del proyecto

Para obtener el PROJECT_NUMBER_OR_ID de tu proyecto de Google Cloud, sigue estos pasos:

  1. Ve a la página Descripción general del proyecto en la consola de Cloud.

  2. Si se solicita, selecciona tu proyecto.

  3. El Número del proyecto y el ID del proyecto aparecen en el área Información del proyecto de la pantalla de descripción general.

Obtén un token de OAuth

Para la autenticación, la solicitud a la API debe contener un token de OAuth en el encabezado Authorization. Para obtener más información, consulta Usa OAuth.

Por ejemplo, usa el siguiente comando gcloud para generar el token:

gcloud auth application-default print-access-token

Puedes incluir el comando gcloud directamente en el encabezado Authorization en un comando cURL para generar un token nuevo en cada solicitud, como se muestra en el ejemplo anterior.

Como alternativa, puedes establecer una variable de entorno que contenga el token y, luego, pasar la variable de entorno como parte de la solicitud:

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