L'API Places (nouvelle version) est compatible avec l'utilisation du protocole OAuth 2.0 pour l'authentification. Google accepte les scénarios OAuth 2.0 courants, tels que ceux pour un serveur Web.
Ce document explique comment transmettre un jeton OAuth à l'appel de l'API Places (New) dans votre environnement de développement. Pour obtenir des instructions sur l'utilisation d'OAuth dans un environnement de production, consultez la page Authentification chez Google.
Avant de commencer
Pour pouvoir utiliser l'API Places (nouvelle version), vous devez disposer d'un projet avec un compte de facturation et l'API Places (nouvelle) activée. Nous vous recommandons de désigner plusieurs propriétaires de projet et administrateurs de la facturation afin d'avoir toujours quelqu'un de disponible pour ces rôles dans votre équipe. Pour en savoir plus, consultez Configurer vos projets dans la console Cloud.
À propos d'OAuth
Il existe de nombreuses façons de créer et de gérer des jetons d'accès avec OAuth, en fonction de votre environnement de déploiement.
Par exemple, le système Google OAuth 2.0 accepte les interactions de serveur à serveur, comme celles entre votre application et un service Google. Dans ce scénario, vous avez besoin d'un compte de service, qui appartient à votre application et non à un utilisateur final individuel. Votre application appelle des API Google au nom du compte de service. Les utilisateurs ne sont donc pas directement impliqués. Pour en savoir plus sur les méthodes d'authentification, consultez la page Authentification chez Google.
Vous pouvez également utiliser l'API Places (nouvelle version) dans une application mobile Android ou iOS. Pour obtenir des informations générales sur l'utilisation d'OAuth avec l'API Places (nouvelle version), y compris sur la gestion des jetons d'accès pour différents environnements de déploiement, consultez Utiliser OAuth 2.0 pour accéder aux API Google.
À propos des champs d'application OAuth
Pour utiliser OAuth avec l'API Places (nouvelle version), vous devez attribuer le champ d'application suivant au jeton OAuth:
https://www.googleapis.com/auth/cloud-platform
Exemple: Essayez les appels d'API REST dans votre environnement de développement local
Si vous souhaitez essayer l'API Places (nouvelle version) à l'aide d'un jeton OAuth, mais que vous n'avez pas configuré d'environnement pour générer des jetons, vous pouvez suivre la procédure décrite dans cette section pour effectuer l'appel.
Cet exemple explique comment effectuer l'appel à l'aide du jeton OAuth fourni par les identifiants par défaut de l'application (ADC). Pour en savoir plus sur l'utilisation d'ADC pour appeler des API Google à l'aide de bibliothèques clientes, consultez S'authentifier à l'aide de bibliothèques clientes.
Prérequis
Avant de pouvoir envoyer une requête REST à l'aide d'ADC, utilisez la Google Cloud CLI pour fournir des identifiants à ADC:
- Si vous ne l'avez pas déjà fait, créez un projet et activez la facturation en suivant la procédure décrite dans la section Configurer dans la console Google Cloud.
- Installez et initialisez la gcloud CLI.
Exécutez la commande
gcloud
suivante sur votre ordinateur local pour créer le fichier d'identifiants:gcloud auth application-default login
- Un écran de connexion s'affiche. Une fois que vous êtes connecté, vos identifiants sont stockés dans le fichier d'identifiants local utilisé par ADC.
Pour en savoir plus, consultez la section Environnement de développement local de la documentation Fournir des identifiants pour les identifiants par défaut de l'application.
Envoyer une requête REST
Dans cet exemple, vous transmettez deux en-têtes de requête:
Transmettez le jeton OAuth dans l'en-tête
Authorization
en utilisant la commande suivante pour le générer:gcloud auth application-default print-access-token
Le jeton renvoyé a un champ d'application de
https://www.googleapis.com/auth/cloud-platform.
- Transmettez dans l'en-tête
X-Goog-User-Project
l'ID ou le nom de votre projet Google Cloud pour lequel la facturation est activée. Pour en savoir plus, consultez Configurer vos projets dans la console Cloud.
L'exemple suivant appelle l'API Places (nouvelle version) à l'aide d'un jeton OAuth:
curl -X POST -d '{ "textQuery" : "Spicy Vegetarian Food in Sydney, Australia" }' \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "X-Goog-User-Project: PROJECT_ID" \ -H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \ "https://places.googleapis.com/v1/places:searchText"
Dépannage
Si votre requête renvoie un message d'erreur indiquant que les identifiants de l'utilisateur final ne sont pas compatibles avec cette API, consultez la section Les identifiants de l'utilisateur ne fonctionnent pas.