Paramètres de requête obligatoires

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

  • 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 la facturation et les calculs des quotas d'utilisation.

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

  • Un numéro ou un 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 à celui spécifié dans l'en-tête X-Goog-User-Project, il n'est pas obligatoire.

  • ID de l'ensemble de données dans l'URL de la requête. Chaque fois que vous effectuez une action sur un ensemble de données spécifique, vous transmettez l'ID de l'ensemble de données 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 nom d'utilisateur (PROJECT_NUMBER_OR_ID) de votre projet Google Cloud, procédez comme suit:

  1. Accédez à la page de présentation du projet 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 zone Informations sur le projet de l'écran "Vue d'ensemble".

Obtenir un jeton OAuth

Pour l'authentification, votre requête API doit contenir un jeton OAuth dans l'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 d'une commande cURL pour générer un nouveau jeton à chaque requête, comme illustré dans l'exemple ci-dessus.

Vous pouvez également définir une variable d'environnement contenant le jeton, puis la transmettre 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