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 problemi, ti consigliamo vivamente di eseguire l'upgrade alla versione .NET prima della fine del 2024.

Questa guida illustra come configurare OAuth 2.0 per l'accesso alle API utilizzando le tue credenziali e il flusso per computer o il flusso web. Questi passaggi devono essere eseguiti solo una volta, a meno che non revochi, elimini o debba modificare gli ambiti consentiti per le tue credenziali OAuth 2.0.

Creare le credenziali OAuth 2.0

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 client secret, quindi torna a questa pagina.

Configura la libreria client

I passaggi che seguono eseguono un esempio di codice interattivo che richiede il tuo input.

1. In un terminale, esegui l'esempio GenerateUserCredentials. Inserisci l'ID client e il client secret OAuth 2.0 quando richiesto.

   dotnet run GenerateUserCredentials.csproj
   

2. Questo esempio di codice apre automaticamente un URL nel browser. Se non hai eseguito l'accesso alla sessione del browser, la pagina web ti chiederà di accedere al tuo Account Google. Se hai già eseguito l'accesso, verrà ignorata la richiesta di accesso e ti reindirizzeremo a un URL in cui dovrai autorizzare l'app ad accedere al tuo account Google Ads per tuo conto.

   Accedi con l'Account Google che utilizzi per accedere a Google Ads. Di solito si tratta di un'email di accesso a un account amministratore Google Ads contenente tutti gli account che devi gestire nella gerarchia dell'account. Fai clic su Continua nella schermata di consenso OAuth 2.0.

   

   Verrà visualizzata una pagina con un messaggio che indica che l'autorizzazione è andata a buon fine.

   Your refresh token has been fetched. Check the
   console output for further instructions.

3. Torna alla console in cui stai eseguendo l'esempio di codice. Vedrai che l'esempio di codice è stato completato e vengono visualizzati il token di aggiornamento e alcune istruzioni, seguite dalle istruzioni da seguire 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 = '******' />
   

   Assicurati di impostare anche l'intestazione LOGIN_CUSTOMER_ID nel file App.config. Per saperne di più, consulta la guida alla configurazione.

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

   Per opzioni di configurazione alternative, consulta la guida alla configurazione.

Generare credenziali OAuth2 per le applicazioni interattive

Se non conosci in anticipo l'account Google Ads a cui effettuare chiamate API, puoi trovarlo in fase di esecuzione 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 esecuzione.