Parámetros de solicitud obligatorios

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

  • El número o ID de tu proyecto de Google Cloud en la Encabezado X-Goog-User-Project de la solicitud. Este valor determina la proyecto usado para la facturación y los cálculos de cuotas de uso.

  • Un token de OAuth en el encabezado Authorization de la solicitud. Para ver más información sobre el uso de OAuth con la API de Maps Datasets, consulta Usa 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. Aunque este proyecto suele que el proyecto especificado en el encabezado X-Goog-User-Project, no es necesario que sean iguales.

  • El ID del conjunto de datos en la URL de la solicitud. Cada vez que realices una acción en un para 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, haz lo siguiente:

  1. Ve a la sección de recursos Página Resumen 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 la sección Información del proyecto de la pantalla Recientes.

Obtén un token de OAuth

Para la autenticación, tu solicitud a la API debe contener un token 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 de una cURL para generar un token nuevo en cada solicitud, como se muestra en el ejemplo arriba.

Como alternativa, puedes establecer una variable de entorno que contenga el token y, luego, pasa 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