Flussi di applicazioni web e desktop OAuth

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

Questa guida illustra come configurare OAuth2 per l'accesso API utilizzando le 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 posto account amministratore Google Ads.

2. Utilizza la GenerateUserCredentials esempio per generare credenziali OAuth2 per un utente con accesso al gestore .

3. Utilizza le credenziali OAuth2 per chiamare tutti gli account di cui hai bisogno gestire utilizzando l'API Google Ads.

Questi passaggi devono essere eseguiti una sola volta, a meno che tu 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 dell'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 GenerateUserCredentials in cui vengono richiesti l'ID client e il secret OAuth2.

   Questo è un esempio interattivo per cui dovrai fornire di testo.

   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 effettuato l'accesso nella sessione del browser, la pagina web ti chiederà di accedere Account Google Se hai già eseguito l'accesso, l'accesso verrà ignorato e ti reindirizza a un URL in cui ti viene chiesto di autorizzare un'applicazione di accesso all'account Google Ads per tuo conto.

   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 che devi gestire sotto la relativa gerarchia.

   

4. Si apre una pagina con un messaggio che indica che autorizzazione riuscita.

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

5. Torna alla console in cui stavi eseguendo l'esempio. L'esempio dovrebbe completato e visualizzando il token di aggiornamento e alcune istruzioni, seguito dalle proprietà che dovrai 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 in anticipo a quale account Google Ads effettuare chiamate API, puoi in fase di runtime, utilizzando le credenziali dell'utente che ha eseguito l'accesso durante la sessione. Consulta AuthenticateInAspNetCoreApplication ad esempio quando l'utente che ha eseguito l'accesso è autenticato e il protocollo OAuth2 vengono ottenute in fase di runtime.