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 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. Scarica il file JSON del client facendo prima clic sull'icona Scarica client OAuth e poi sul pulsante SCARICA JSON nella schermata seguente.

    Salva il file nella tua home directory in modo da avere il file locale~/client_secret_XXX.apps.googleusercontent.com.json (dove XXX saranno i valori specifici del tuo progetto). Utilizzeremo questo file nel passaggio successivo per eseguire l'esempio di codice.

Configura la libreria client

  1. In un terminale, esegui l'esempio di codice GenerateUserCredentials. Utilizza i flag della riga di comando per passare il file JSON OAuth 2.0 che hai scaricato.

    Puoi utilizzare il seguente comando per eseguire l'esempio di codice dalla riga di comando utilizzando Gradle:
    ./gradlew --console=plain --quiet runExample \
          --example="authentication.GenerateUserCredentials \
          --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
        
  2. Questo esempio di codice ti chiederà di visitare un URL in cui dovrai autorizzare l'app ad accedere al tuo account Google Ads per tuo conto.

    Paste this URL in your browser:
    https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...
        

    Vai all'URL in una sessione del browser privata o in una finestra di navigazione in incognito. 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 che contiene tutti gli account che devi gestire nella gerarchia dell'account. Fai clic su Continua nella schermata di consenso OAuth 2.0.

    Schermata per il consenso OAuth 2.0

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

    Authorization code was successfully retrieved.
    
    Check the console output from `GenerateUserCredentials` 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:

        #Mon Apr 18 09:07:51 EDT 2022
        api.googleads.refreshToken=1/Yw.........................................
        api.googleads.clientId=...........-...............apps.googleusercontent.com
        api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
        api.googleads.clientSecret=........................
        
  4. Copia le righe dal commento della data # alla fine dell'output nel file ads.properties.

    Sostituisci INSERT_DEVELOPER_TOKEN_HERE con il tuo token sviluppatore.

    Per la configurazione più semplice, posiziona il file ads.properties nella home directory.