Flussi di applicazioni web e desktop OAuth

Avviso:a partire dalla versione 19.0.0, la libreria client dell'API Google Ads per .NET non supporterà più .NET 5.0. Per garantire un funzionamento senza interruzioni, ti consigliamo vivamente di eseguire l'upgrade della versione di .NET prima della fine del 2024.

Questa guida illustra come configurare OAuth2 per l'accesso 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 dell'API Google Ads è

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

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

3. Utilizza le credenziali OAuth2 per chiamare tutti gli account da gestire con l'API Google Ads.

Questi passaggi devono essere eseguiti una sola volta, a meno che non revochi, elimini o non sia necessario modificare 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 dell'ID client e del segreto, poi 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 input.

   dotnet run GenerateUserCredentials.csproj
   

2. L'esempio richiede di fornire l'ID client e il segreto OAuth2. Fornisci i dettagli del 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à ignorata e il sistema ti reindirizzerà a un URL in cui ti verrà chiesto di autorizzare l'applicazione ad accedere per tuo conto al tuo account Google Ads.

   Nota: accedi con lo stesso Account Google che utilizzi per accedere a Google Ads. Di solito, si tratta di un'email di accesso a un account amministratore Google Ads che contiene tutti gli account da gestire sotto la gerarchia degli account.

   

4. Viene visualizzata una pagina con un messaggio che indica che l'autorizzazione è riuscita.

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

5. Torna alla console in cui stavi eseguendo l'esempio. L'esempio dovrebbe essere stato completato e dovrebbe essere visualizzato 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 conosci l'account Google Ads a cui effettuare chiamate API in anticipo, puoi scoprirlo in fase di runtime utilizzando le credenziali dell'utente che ha eseguito l'accesso per la sessione. Consulta AuthenticateInAspNetCoreApplication per un esempio in cui l'utente che ha eseguito l'accesso viene autenticato e le credenziali OAuth2 vengono ottenute in fase di runtime.