Paramètres de requête obligatoires

Pour envoyer une requête à l'API Maps Datasets, vous devez inclure:

  • Numéro ou ID de votre projet Google Cloud dans l'en-tête X-Goog-User-Project de la requête. Cette valeur détermine le projet utilisé pour les calculs de facturation et de quota d'utilisation.

  • Un jeton OAuth dans l'en-tête Authorization de la requête Pour plus sur l'utilisation d'OAuth avec l'API Maps Datasets, consultez Utiliser OAuth.

  • Numéro ou ID de projet Google Cloud dans l'URL de la requête. Cette valeur spécifie le projet contenant l'ensemble de données. Bien que ce projet soit généralement identique au projet spécifié dans l'en-tête X-Goog-User-Project, il ne doit pas nécessairement être identique.

  • ID de l'ensemble de données dans l'URL de la requête. Chaque fois que vous effectuez une action un ensemble de données spécifique, vous transmettez son ID dans l'URL de la requête.

Par exemple, pour supprimer un ensemble de données:

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

Obtenir le numéro du projet

Pour obtenir le PROJECT_NUMBER_OR_ID de votre projet Google Cloud:

  1. Accédez à l'onglet Page Vue d'ensemble dans la console Cloud.

  2. Si vous y êtes invité, sélectionnez votre projet.

  3. Le numéro du projet et l'ID du projet apparaissent dans la section Informations sur le projet. de l'écran "Overview" (Aperçu).

Obtenir un jeton OAuth

Pour l'authentification, votre requête API doit contenir un jeton OAuth dans En-tête Authorization. Pour en savoir plus, consultez Utiliser OAuth.

Par exemple, utilisez la commande gcloud suivante pour générer le jeton:

gcloud auth application-default print-access-token

Vous pouvez inclure la commande gcloud directement dans l'en-tête Authorization dans une cURL pour générer un nouveau jeton pour chaque requête, comme illustré dans l'exemple ci-dessus.

Vous pouvez également définir une variable d'environnement contenant le jeton, puis transmettez la variable d'environnement dans la requête:

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