Tous les appels à l'API Local Services doivent être autorisés via OAuth 2.0. Cela permet à votre application cliente de l'API Local Services d'accéder au compte Annonces Local Services d'un utilisateur sans avoir à gérer ni à stocker ses informations de connexion.
L'API Local Services utilise le protocole OAuth 2.0 pour authentifier les utilisateurs. Pour en savoir plus sur OAuth 2.0, consultez Utiliser OAuth 2.0 pour accéder aux API Google.
Configurer un projet de la console Google APIs pour l'API Local Services
Pour authentifier et autoriser les utilisateurs Google Ads, vous devez disposer d'identifiants permettant d'accéder aux serveurs OAuth 2.0 de Google. Ces identifiants permettent d'identifier votre application auprès de Google et de générer des jetons OAuth pour gérer les utilisateurs Google Ads. Utilisez la console Google APIs pour gérer l'accès à vos identifiants Google OAuth 2.0.
Pour recevoir ces identifiants, procédez comme suit :
Créez un projet. Pour ce faire, accédez à la console Google APIs. Cliquez sur Créer un projet, saisissez un nom, puis cliquez sur Créer.
Activez l'API Local Services dans votre projet :
Ouvrez la bibliothèque d'API dans la console Google APIs. Si vous y êtes invité, sélectionnez votre projet ou créez-en un. La bibliothèque d'API répertorie toutes les API disponibles, regroupées par famille de produits et par popularité.
Si l'API Local Services n'apparaît pas dans la liste, utilisez le champ de recherche pour la trouver.
Sélectionnez l'API Local Services, puis cliquez sur Activer.
Choisissez un type d'application. L'API Local Services utilise les mêmes types d'applications que l'API Google Ads. Pour en savoir plus sur le type d'application à utiliser, consultez Choisir un type d'application.
Créez un ID client et un code secret client. Pour l'API Local Services, suivez la même procédure pour créer un ID client et un code secret de client que pour l'API Google Ads. Les étapes sont identiques pour les deux cas d'utilisation.
Utiliser la bibliothèque cliente pour obtenir des jetons OAuth 2.0
Pour obtenir la liste des bibliothèques clientes que vous pouvez utiliser pour envoyer des requêtes d'autorisation OAuth 2.0, consultez Bibliothèques clientes. Suivez les instructions spécifiques à la bibliothèque pour savoir comment utiliser un jeton d'actualisation afin d'obtenir un nouveau jeton d'accès.
Obtenir un jeton d'actualisation OAuth 2.0
Nous vous recommandons d'utiliser les bibliothèques clientes en production pour authentifier les utilisateurs. Si vous souhaitez utiliser un client HTTP à des fins de test, suivez les instructions ci-dessous pour obtenir un jeton d'actualisation et un jeton d'accès OAuth 2.0. Les étapes 1, 2 et 3 sont des instructions de configuration ponctuelle que vous devez effectuer manuellement. Les étapes 4 et 5 peuvent ensuite être automatisées pour s'exécuter sans intervention humaine, comme une tâche cron.
Téléchargez et installez curl, un outil de ligne de commande permettant d'envoyer des requêtes Web HTTP.
Suivez les instructions de la page OAuth Playground pour obtenir un jeton d'actualisation OAuth 2.0. Utilisez le champ d'application suivant pour l'API Local Services :
https://www.googleapis.com/auth/adwordsIl s'agit du même champ d'application OAuth 2.0 que celui utilisé par l'API Google Ads.
À la fin de cette étape, vous recevrez deux jetons : un jeton d'actualisation et un jeton d'accès. Enregistrez les deux.
Exécutez la commande suivante dans une invite de commande pour vérifier que l'étape précédente a réussi :
curl https://oauth2.googleapis.com/tokeninfo?access_token=<INSERT_ACCESS_TOKEN>Si le résultat de la commande affiche un message semblable à celui-ci, cela signifie que l'opération a réussi :
{ "azp": "************-********************************.apps.googleusercontent.com", "aud": "************-********************************.apps.googleusercontent.com", "scope": "https://www.googleapis.com/auth/adwords [googleapis.com]", "exp": "1611183382", "expires_in": "3482", "access_type": "offline" }En cas d'erreur ou si le champ d'application n'est pas correct, essayez de générer à nouveau les jetons.
Générez un jeton d'accès sans intervention manuelle. C'est important, car les jetons d'accès expirent toutes les heures. Les jetons d'actualisation mettent beaucoup plus de temps à expirer. Vous devez donc souvent les révoquer manuellement lorsqu'ils ne sont plus nécessaires.
Pour obtenir un nouveau jeton d'accès, exécutez la commande suivante :
curl --data "refresh_token=<INSERT_REFRESH_TOKEN>&client_id=<INSERT_CLIENT_ID>&client_secret=<INSERT_CLIENT_SECRET>&grant_type=refresh_token" -X POST "https://oauth2.googleapis.com/token”Exécutez l'appel d'API suivant :
curl -H "Authorization: Bearer <INSERT_ACCESS_TOKEN>" https://localservices.googleapis.com/v1/accountReports:search?query=manager_customer_id:<INSERT_10_DIGIT_MANAGER_CUSTOMER_ID_WITHOUT_HYPHENS>Si cet appel aboutit, votre configuration est terminée.