Flux OAuth des applications de bureau et Web

Ce guide vous explique comment configurer OAuth2 pour l'accès à l'API à l'aide de vos propres identifiants et du flux pour ordinateur ou du flux Web. Cette procédure ne doit être effectuée qu'une seule fois, sauf si vous révoquez, supprimez ou devez modifier les champs d'application autorisés pour vos identifiants OAuth2.

Créer des identifiants OAuth2

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

  2. Téléchargez le fichier JSON du client en cliquant d'abord sur l'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 du fichier local ~/client_secret_XXX.apps.googleusercontent.com.json (où XXX sera les 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 des 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 avec Gradle

    ./gradlew --console=plain --quiet runExample \
      --example="authentication.GenerateUserCredentials \
      --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
    
  2. L'exemple vous invite à accéder à une URL pour 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 ou une fenêtre de navigation privée. Connectez-vous avec le compte Google que vous utilisez pour accéder à Google Ads. Cliquez sur Continue (Continuer) sur l'écran de consentement OAuth2.

    Écran de consentement

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

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

    Pour obtenir des instructions supplémentaires, consultez les résultats de GenerateUserCredentials dans la console.

  4. Revenez à la console où vous exécutez l'exemple. L'exemple est terminé et affiche votre jeton d'actualisation et quelques instructions, ainsi que les propriétés dont vous aurez 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 du commentaire de date # à 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.