Fluxos de aplicativos da Web e área de trabalho OAuth

Neste guia, explicamos como configurar o OAuth2 para acesso à API usando suas próprias credenciais e o fluxo de computador ou o fluxo da Web. Essas etapas precisam ser realizadas apenas uma vez, a menos que você revogue, exclua ou altere os escopos permitidos para as credenciais do OAuth2.

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 ter o arquivo local ~/client_secret_XXX.apps.googleusercontent.com.json (em que XXX são valores específicos do projeto). Vamos usar esse arquivo na próxima etapa para executar o exemplo de código.

Configure a biblioteca de cliente.

  1. Em um terminal, execute o exemplo GenerateUserCredentials. Use flags de linha de comando para transmitir o arquivo JSON que você salvou na etapa anterior.

    Executar na linha de comando usando o Gradle

    ./gradlew --console=plain --quiet runExample \
      --example="authentication.GenerateUserCredentials \
      --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
    
  2. O exemplo solicita que você acesse um URL no qual será necessário permitir que as credenciais do OAuth2 acessem sua 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=****...
    

    Acesse o URL em uma sessão particular do navegador 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 permissão do OAuth2.

    Tela de consentimento

  3. Você será direcionado a uma página com uma mensagem indicando que a autorização foi bem-sucedida.

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

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

  4. Volte para o console em que você está executando o exemplo. Você verá que o exemplo foi concluído e está exibindo o token de atualização e algumas instruções, seguidos 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 no 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.