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 les calculs de facturation et de quota 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 la section 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 à celui spécifié dans l'en-tête X-Goog-User-Project, il n'est pas obligatoire qu'il le soit.

  • 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 PROJECT_NUMBER_OR_ID de votre projet Google Cloud:

  1. Accédez à la page "Vue d'ensemble" du projet dans Cloud Console.

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

  3. Le numéro de projet et l'ID de projet s'affichent dans la section Informations sur le projet de l'écran "Vue d'ensemble".

Obtenir un jeton OAuth

Pour l'authentification, votre requête d'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 indiqué dans l'exemple ci-dessus.

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