Fluxos OAuth e de aplicativos da Web para OAuth

Este guia mostra como configurar o OAuth2 para acesso à API usando suas próprias credenciais e o fluxo da área de trabalho ou o fluxo da Web. Essas etapas só precisam ser feitas uma vez, a menos que você revogue, exclua ou altere os escopos permitidos para suas credenciais do OAuth2.

Etapa 1: criar credenciais do OAuth2

  1. Siga as etapas para configurar um projeto do Console de APIs do Google para a API Google Ads.

  2. Faça o download do arquivo JSON do cliente clicando no ícone Fazer o download do cliente OAuth e, em seguida, no botão FAZER O DOWNLOAD DO JSON na tela seguinte.

    Salve o arquivo no diretório principal para que você tenha o arquivo local ~/client_secret_XXX.apps.googleusercontent.com.json (em que XXX será valores específicos para seu projeto). Usaremos esse arquivo na próxima etapa para executar o exemplo do código.

Etapa 2: configurar a biblioteca de cliente

  1. Em um terminal, execute o exemplo do GenerateUserCredentials. Use sinalizações de linha de comando para enviar o arquivo JSON que você salvou na etapa anterior.

    Executar pela linha de comando usando o Gradle

    ./gradlew --console=plain --quiet runExample \
      --example="authentication.GenerateUserCredentials \
      --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
    
  2. No exemplo, você precisa acessar um URL em que é necessário permitir que as credenciais do OAuth2 acessem a conta do Google Ads em seu nome.

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

    Navegue até o URL em uma sessão de navegador privada ou em uma janela anônima. Faça login com a mesma Conta do Google que você usa para acessar o Google Ads. Clique em Continuar na tela de consentimento do OAuth2.

    Continuar com a tela de consentimento

  3. Você será direcionado a uma página com uma mensagem indicando que a autorização foi concluída.

    O código de autorização foi recuperado.

    Verifique a saída do console de GenerateUserCredentials para ver mais instruções.

  4. Volte ao console em que o exemplo está sendo executado. Você verá que o exemplo foi concluído e está exibindo o token de atualização e algumas instruções, seguidas pelas propriedades necessárias para configurar a biblioteca de cliente:

    #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. Copie as linhas do comentário de data # para o final da saída para o arquivo ads.properties.

    Substitua INSERT_DEVELOPER_TOKEN_HERE pelo seu token de desenvolvedor.

    Para facilitar a configuração, coloque o arquivo ads.properties no seu diretório principal.