Flussi di applicazioni web e desktop OAuth

Questa guida illustra come configurare OAuth2 per l'accesso API utilizzando le tue credenziali e il flusso desktop o il flusso web. Questi passaggi devono essere eseguiti una sola volta, a meno che non revochino, eliminino o modifichino gli ambiti consentiti per le credenziali OAuth2.

Crea credenziali OAuth2

  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 clic prima sulla relativa icona Scarica client OAuth, poi sul pulsante SCARICA JSON nella schermata seguente.

    Salva il file nella tua directory home 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.

Configurare la libreria client

  1. In un terminale, esegui l'esempio GenerateUserCredentials. Utilizza i flag della riga di comando per passare il file JSON scaricato nel passaggio precedente.

    Eseguire dalla riga di comando utilizzando Gradle

    ./gradlew --console=plain --quiet runExample \
      --example="authentication.GenerateUserCredentials \
      --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
    
  2. L'esempio ti chiederà di visitare un URL in cui dovrai consentire alle credenziali OAuth2 di 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=****...
    

    Accedi all'URL in una sessione di navigazione privata o in una finestra di navigazione in incognito. Accedi con lo stesso Account Google che utilizzi per accedere a Google Ads. Fai clic su Continua nella schermata per il consenso OAuth2.

    Schermata consenso

  3. Verrà visualizzata una pagina con un messaggio che indica che l'autorizzazione è riuscita.

    Codice di autorizzazione recuperato.

    Controlla l'output della console da GenerateUserCredentials per ulteriori istruzioni.

  4. Torna alla console su cui stai eseguendo l'esempio. Vedrai che l'esempio è stato completato e mostra il token di aggiornamento e alcune istruzioni, seguite dalle proprietà necessarie 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=........................
    
  5. 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 una configurazione più semplice, posiziona il file ads.properties nella directory home.