Flussi di applicazioni web e desktop OAuth

Questa guida illustra come configurare OAuth2 per l'accesso all'API utilizzando le tue credenziali e il flusso desktop o il flusso web.

Generare credenziali OAuth2 per un singolo account

Il modo più semplice per effettuare chiamate agli account API di Google Ads è

1. Collega tutti gli account ai quali vuoi effettuare chiamate API in un unico account amministratore Google Ads.

2. Utilizza l'esempio GenerateUserCredentials per generare credenziali OAuth2 per un utente con accesso all'account amministratore.

3. Utilizza le credenziali OAuth2 per effettuare chiamate a tutti gli account che devi gestire con l'API Google Ads.

Questi passaggi devono essere eseguiti una sola volta, a meno che non revochino, eliminino o modifichino gli ambiti consentiti per le credenziali OAuth2.

Passaggio 1 - Crea le credenziali OAuth2

1. Segui i passaggi per configurare un progetto della console API di Google per l'API Google Ads.

2. Prendi nota del client ID e del segreto, quindi torna a questa pagina.

Passaggio 2: configura la libreria client

1. In un terminale, esegui l'esempio GenerateUserCredentials, che richiede l'ID client e il secret OAuth2.

   Questo è un esempio interattivo che richiede un intervento.

   dotnet run GenerateUserCredentials.csproj
   

2. L'esempio richiede di fornire l'ID client e il segreto OAuth2. Fornisci i dettagli nel passaggio 1.

3. L'esempio apre automaticamente un URL nel browser. Se non hai eseguito l'accesso alla sessione del browser, la pagina web ti chiederà di accedere all'Account Google. Se hai già eseguito l'accesso, la richiesta di accesso verrà saltata e verrà reindirizzata a un URL in cui ti viene chiesto di autorizzare l'applicazione ad accedere al tuo account Google Ads per tuo conto.

   Nota: accedi con lo stesso Account Google che utilizzi per accedere a Google Ads. In genere, questa è un'email di accesso a un account amministratore Google Ads contenente tutti gli account che devi gestire nella rispettiva gerarchia di account.

   

4. Si aprirà una pagina con un messaggio che indica che l'autorizzazione è andata a buon fine.

   Il token di aggiornamento è stato recuperato. Controlla l'output della console per ulteriori istruzioni.

5. Torna alla console su cui stavi eseguendo l'esempio. L'esempio dovrebbe essere stato completato e visualizzare il token di aggiornamento e alcune istruzioni, seguite dalle proprietà necessarie per configurare la libreria client:

   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.
   

Generare credenziali OAuth2 per applicazioni interattive

Se non sai con quale account Google Ads effettuare chiamate API in anticipo, puoi scoprirlo in fase di runtime utilizzando le credenziali dell'utente che ha eseguito l'accesso alla sessione. Vedi AuthenticateInAspNetCoreApplication per un esempio in cui l'utente che ha eseguito l'accesso è autenticato e le credenziali OAuth2 vengono ottenute in fase di runtime.