Flussi di applicazioni web e desktop OAuth

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

Crea credenziali OAuth 2.0

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

2. Prendi nota dell'ID client e del client secret, poi torna a questa pagina.

Configurare la libreria client

I seguenti passaggi eseguono un esempio di codice interattivo, che ti chiederà di fornire input.

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

   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, il prompt di accesso verrà ignorato e verrà eseguito il reindirizzamento a un URL in cui devi 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. In genere, si tratta di un'email di accesso a un account amministratore Google Ads che contiene tutti gli account che devi gestire nella gerarchia dell'account. Fai clic su Continua nella schermata per il 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 mostra il token di aggiornamento e alcune istruzioni, seguite da quelle che dovrai 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' />
   

   Consulta la guida alla configurazione per opzioni di configurazione alternative.

Generare credenziali OAuth2 per applicazioni interattive

Se non conosci in anticipo l'account Google Ads a cui effettuare chiamate API, 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 attualmente connesso viene autenticato e le credenziali OAuth2 vengono ottenute in fase di runtime.