Flux OAuth des applications pour ordinateur et Web

Ce guide vous explique comment configurer OAuth2 pour l'accès API à l'aide de vos propres identifiants et du flux sur ordinateur ou du flux Web. Ces étapes ne doivent être effectuées qu'une seule fois, sauf si vous révoquez, supprimez ou modifiez les habilitations autorisées pour vos identifiants OAuth2.

Créer des identifiants OAuth2

  1. Suivez la procédure pour configurer un projet de console Google API pour l'API Google Ads.

  2. Téléchargez le fichier JSON du client en cliquant sur son icône Télécharger le client OAuth, puis sur le bouton TÉLÉCHARGER JSON sur l'écran suivant.

    Enregistrez le fichier dans votre répertoire d'accueil afin de disposer à présent du fichier local ~/client_secret_XXX.apps.googleusercontent.com.json (où XXX correspondra à des valeurs spécifiques à votre projet). Nous utiliserons ce fichier à l'étape suivante pour exécuter l'exemple de code.

Configurez la bibliothèque cliente

  1. Dans un terminal, exécutez l'exemple GenerateUserCredentials. Utilisez les indicateurs de ligne de commande pour lui transmettre le fichier JSON que vous avez téléchargé à l'étape précédente.

    Exécuter à partir de la ligne de commande à l'aide de Gradle

    ./gradlew --console=plain --quiet runExample \
      --example="authentication.GenerateUserCredentials \
      --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
    
  2. L'exemple vous invite à consulter une URL sur laquelle vous devez autoriser les identifiants OAuth2 à accéder à votre compte Google Ads en votre nom.

    Paste this URL in your browser:
    https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...
    

    Accédez à l'URL dans une session privée du navigateur ou dans une fenêtre de navigation privée. Connectez-vous avec le compte Google que vous utilisez pour accéder à Google Ads. Cliquez sur Continuer sur l'écran de consentement OAuth2.

    Écran de consentement

  3. Vous serez redirigé vers une page indiquant que l'autorisation a abouti.

    Le code d'autorisation a bien été récupéré.

    Pour en savoir plus, consultez la sortie de la console de GenerateUserCredentials.

  4. Revenez à la console dans laquelle vous exécutez l'exemple. Vous verrez que l'exemple est terminé et qu'il affiche votre jeton d'actualisation ainsi que des instructions, suivies des propriétés dont vous avez besoin pour configurer la bibliothèque cliente:

    #Mon Apr 18 09:07:51 EDT 2022
    api.googleads.refreshToken=1/Yw.........................................
    api.googleads.clientId=...........-...............apps.googleusercontent.com
    api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
    api.googleads.clientSecret=........................
    
  5. Copiez les lignes de la date de commentaire # à la fin du résultat dans votre fichier ads.properties.

    Remplacez INSERT_DEVELOPER_TOKEN_HERE par votre jeton de développeur.

    Pour une configuration plus simple, placez le fichier ads.properties dans votre répertoire d'accueil.