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 los cálculos de 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 especificado en el encabezado X-Goog-User-Project, no es obligatorio que sea el mismo.

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

Por ejemplo, para borrar un conjunto de datos, haz lo siguiente:

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 de 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 de 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 Cómo usar 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, pasarla 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