Configurer l'autorisation

L'API Search Ads 360 exige que toutes les requêtes spécifient un jeton d'accès OAuth 2.0. Vous pouvez suivre n'importe quel workflow d'authentification OAuth 2.0 standard pour générer le jeton et le transmettre à l'API Search Ads 360. Nous vous recommandons d'utiliser le workflow décrit ci-dessous, car il convient aux importations de conversions entièrement automatisées et au téléchargement de rapports.

Pour découvrir d'autres solutions que celles décrites ci-dessous, consultez les pages Utiliser OAuth 2.0 pour les applications installées ou Utiliser OAuth 2.0 pour les applications de serveur à serveur. Si vous utilisez un autre workflow, spécifiez la valeur suivante en tant que paramètre scope lorsque vous demandez un code d'autorisation OAuth 2.0:
https://www.googleapis.com/auth/doubleclicksearch
Si vous suivez la route de serveur à serveur, ajoutez le compte de service en tant qu'utilisateur Search Ads 360.

Workflow d'autorisation recommandé

1. Accédez à la console Google APIs, puis sélectionnez votre projet.

   Si vous n'avez pas encore créé de projet dans la console Google API et d'identifiants OAuth, suivez les instructions de la section Créer un projet dans la console Google API et des identifiants OAuth pour votre client.

   Pour trouver l'ID client et le code secret OAuth de votre projet, procédez comme suit:

   1. Ouvrez la page Identifiants.
   2. Dans la colonne Nom, cliquez sur le nom de votre client OAuth.
   3. L'ID client et le code secret sont indiqués sur la page.
2. Ouvrez un navigateur Web et connectez-vous à Google avec un compte Google autorisé à accéder aux données dans Search Ads 360.

   Il s'agit du compte Google que votre client API utilisera pour s'authentifier auprès de Search Ads 360. Si le titulaire du compte Google quitte votre entreprise et que vous supprimez l'accès Search Ads 360 associé, vous devrez répéter cette procédure d'autorisation et spécifier un autre compte Google.

3. Obtenez un jeton d'actualisation en appelant le script utilitaire Search Ads 360 comme suit:

   sa360Api.py --login

   Le script vous guide tout au long du processus d'utilisation de l'ID client OAuth et du secret pour obtenir un jeton d'actualisation. Le jeton d'actualisation n'est valide que pour le compte Google auquel vous vous êtes connecté à l'étape précédente.

   Dans le cadre de ce processus, le script génère une URL et vous demande d'y accéder dans un navigateur Web.

4. Lorsque le navigateur vous demande d'autoriser le client OAuth à accéder aux données Search Ads 360, assurez-vous que le compte Google auquel vous vous êtes connecté précédemment s'affiche. (Si vous êtes connecté à plusieurs comptes Google, un compte différent peut s'afficher.)
   

   À la fin du processus, le script sa360Api.py génère une chaîne séparée par des virgules. La première valeur est l'ID client que vous avez fourni, la deuxième valeur est le code secret du client que vous avez fourni et la troisième valeur est le jeton d'actualisation. Dans l'exemple de résultat suivant, le jeton d'actualisation est en texte en gras :
   123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw

5. Stockez l'ID client, le code secret et le jeton d'actualisation du client dans une base de données backend ou dans un autre emplacement sécurisé accessible à votre application.

   Conservez l'intégralité de la chaîne délimitée par des virgules à un emplacement pratique si vous prévoyez d'utiliser sa360Api.py pour envoyer des exemples de requêtes JSON à l'API Search Ads 360. Vous transmettez la chaîne entière en tant que paramètre chaque fois que vous appelez le script.

6. Ajoutez à votre application le code suivant :
   1. Utilisez l'ID client, le code secret du client et le jeton d'actualisation pour obtenir un nouveau jeton d'accès OAuth 2.0.
   2. Envoyez des requêtes à l'API Search Ads 360 à l'aide du nouveau jeton d'accès.

   Si vous utilisez les bibliothèques clientes, consultez la section suivante, Configurer votre application, qui explique comment ajouter ce code d'autorisation à votre application.

   Si vous n'utilisez pas l'une des bibliothèques clientes, consultez la section Utiliser OAuth 2.0 pour les applications installées pour obtenir des suggestions sur l'obtention d'un nouveau jeton d'accès.