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.

Générer des identifiants OAuth2 pour un seul compte

Le moyen le plus simple d'appeler des comptes API Google Ads consiste à

  1. Associez tous les comptes pour lesquels vous souhaitez effectuer des appels d'API à un seul compte administrateur Google Ads.

  2. Utilisez l'exemple GenerateUserCredentials pour générer des identifiants OAuth2 pour un utilisateur ayant accès au compte administrateur.

  3. Utilisez les identifiants OAuth2 pour appeler tous les comptes que vous devez gérer à l'aide de l'API Google Ads.

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.

Étape 1 : Créez des identifiants OAuth2

  1. Suivez les étapes pour configurer un projet de console Google APIs pour l'API Google Ads.

  2. Notez l'ID client et le code secret, puis revenez sur cette page.

Étape 2 : Configurez la bibliothèque cliente

  1. Dans un terminal, exécutez l'exemple GenerateUserCredentials, qui vous invite à saisir votre ID client et votre code secret OAuth2.

    Il s'agit d'un exemple interactif qui nécessitera une entrée.

    dotnet run GenerateUserCredentials.csproj

  2. L'exemple vous invite à fournir l'ID client et le code secret OAuth2. Fournissez les informations de l'étape 1.

  3. L'exemple ouvre automatiquement une URL dans le navigateur. Si vous n'êtes pas connecté à votre session de navigateur, la page Web vous invite à vous connecter au compte Google. Si vous êtes déjà connecté, l'application ignore l'invite de connexion et vous redirige vers une URL depuis laquelle vous êtes invité à autoriser l'application à accéder à votre compte Google Ads en votre nom.

    Écran de consentement

  4. Vous êtes ensuite redirigé vers une page affichant un message indiquant que l'autorisation a réussi.

    Votre jeton d'actualisation a été récupéré. Pour plus d'informations, consultez la sortie de la console.

  5. Revenez à la console dans laquelle vous avez exécuté l'exemple. L'exemple doit se terminer et afficher votre jeton d'actualisation et quelques instructions, suivi des propriétés dont vous aurez besoin pour configurer la bibliothèque cliente:

    Copy the following content into your App.config file.

<add key = 'OAuth2Mode' value = 'APPLICATION' />
<add key = 'OAuth2ClientId' value = '******' />
<add key = 'OAuth2ClientSecret' value = '******' />
<add key = 'OAuth2RefreshToken' value = '******' />

Make sure you also set the LOGIN_CUSTOMER_ID header. See
https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration#google_ads_api_settings
to learn more.

<add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />

See https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration
for alternate configuration options.

Générer des identifiants OAuth2 pour les applications interactives

Si vous ne connaissez pas à l'avance le compte Google Ads pour effectuer des appels d'API, vous pouvez le découvrir au moment de l'exécution à l'aide des identifiants de l'utilisateur connecté à la session. Consultez la section AuthenticateInAspNetCoreApplication pour voir un exemple dans lequel l'utilisateur actuellement connecté est authentifié et les identifiants OAuth2 sont obtenus au moment de l'exécution.