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 modifiez les champs d'application autorisés pour vos identifiants OAuth2.

Créer des identifiants OAuth2

  1. Suivez les étapes pour configurer un projet de 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 pour obtenir le fichier local ~/client_secret_XXX.apps.googleusercontent.com.json (où XXX sera les valeurs propres à 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 à 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 à 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 de navigateur privée 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 êtes redirigé vers une page affichant un message indiquant que l'autorisation a réussi.

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

    Pour plus d'informations, consultez la sortie de la console sur 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 et quelques instructions, suivi des 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 la plus simple, placez le fichier ads.properties dans votre répertoire d'accueil.