Quer compartilhar seu feedback sobre a API Google Ads? Faça sua inscrição para receber um convite para participar da pesquisa com usuários.

Esta página foi traduzida pela API Cloud Translation.

Fluxos de aplicativos da Web e área de trabalho OAuth

Este guia ensina a configurar o OAuth 2.0 para acesso à API usando suas próprias credenciais e o fluxo para computador ou o fluxo para Web. Essas etapas só precisam ser realizadas uma vez, a menos que você revogue, exclua ou precise mudar os escopos permitidos para suas credenciais do OAuth 2.0.

Criar credenciais do OAuth 2.0

Siga as etapas para configurar um projeto do Console de APIs do Google para a API Google Ads.
Faça o download do arquivo JSON do cliente clicando primeiro no ícone Fazer o download do cliente OAuth e depois no botão FAZER O DOWNLOAD DO JSON na tela seguinte.

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

Configure a biblioteca de cliente.

Em um terminal, execute o exemplo de código GenerateUserCredentials. Use flags de linha de comando para transmitir o arquivo JSON OAuth 2.0 que você fez o download.
Use o comando abaixo para executar o exemplo de código na linha de comando usando o Gradle:
```
./gradlew --console=plain --quiet runExample \
      --example="authentication.GenerateUserCredentials \
      --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
    
```
Este exemplo de código vai solicitar que você acesse um URL em que precisa autorizar o app a acessar 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 de navegação particular ou uma janela anônima. Faça login com a Conta do Google que você usa para acessar o Google Ads. Normalmente, é um e-mail de login de uma conta de administrador do Google Ads que contém todas as contas que você precisa gerenciar na hierarquia. Clique em Continuar na tela de consentimento do OAuth 2.0.

Você vai ser direcionado a uma página com uma mensagem indicando que a autorização foi concluída.
```
Authorization code was successfully retrieved.

Check the console output from `GenerateUserCredentials` for further instructions.
    
```

Volte para o console em que você está executando o exemplo de código. O exemplo de código foi concluído e está mostrando seu token de atualização e algumas instruções, seguidas pelas instruções que você precisa seguir 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=........................

Copie as linhas do comentário de data # até 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 diretório principal.