Vous souhaitez nous faire part de vos commentaires sur l'API Google Ads ? Inscrivez-vous pour être invité à participer à des recherches sur l'expérience utilisateur.

Cette page a été traduite par l'API Cloud Translation.

Flux OAuth des applications de bureau et Web

Ce guide explique comment configurer OAuth 2.0 pour l'accès aux API à l'aide de vos propres identifiants et du flux pour ordinateur ou du flux pour le Web. Vous n'avez besoin d'effectuer ces étapes qu'une seule fois, sauf si vous révoquez, supprimez ou devez modifier les champs d'application autorisés pour vos identifiants OAuth 2.0.

Créer des identifiants OAuth 2.0

Suivez la procédure pour configurer un projet dans la console Google APIs pour l'API Google Ads.
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 à 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 correspond à 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

Dans un terminal, exécutez l'exemple de code GenerateUserCredentials. Utilisez des options de ligne de commande pour lui transmettre le fichier JSON OAuth 2.0 que vous avez téléchargé.
Vous pouvez utiliser la commande suivante pour exécuter l'exemple de code à 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"
    
```
Cet exemple de code vous invite à accéder à une URL sur laquelle vous devez autoriser l'application à 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 une fenêtre de navigation privée. Connectez-vous avec le compte Google que vous utilisez pour accéder à Google Ads. Il s'agit généralement de l'adresse e-mail de connexion à un compte administrateur Google Ads contenant tous les comptes que vous devez gérer dans sa hiérarchie de comptes. Cliquez sur Continuer sur l'écran de consentement OAuth 2.0.

Vous êtes redirigé vers une page affichant un message indiquant que l'autorisation a réussi.
```
Authorization code was successfully retrieved.

Check the console output from `GenerateUserCredentials` for further instructions.
    
```

Revenez à la console dans laquelle vous exécutez l'exemple de code. Vous verrez que l'exemple de code est terminé et affiche votre jeton de rafraîchissement et des instructions, suivies des instructions que vous devrez suivre 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=........................

Copiez les lignes du commentaire de date # à la fin de la sortie 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.