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 OAuth2 para acesso à API usando suas próprias credenciais e o fluxo de computador ou o fluxo da Web. Essas etapas só precisam ser realizadas uma vez, a menos que você revogue, exclua ou precise alterar os escopos permitidos para suas credenciais do OAuth2.

Criar credenciais OAuth2

Siga as etapas para configurar um projeto do Console de APIs do Google para a API Google Ads.
Anote o ID do cliente e o secreto e volte para esta página.

Configure a biblioteca de cliente.

Em um terminal, acesse o exemplo de OAuth2.
- generate_user_credentials.pl
Execute este exemplo usando a linha de comando. É possível modificar os valores de INSERT_XXX_HERE no exemplo antes da execução ou usar argumentos -client_id para o ID do cliente e -client_secret para a chave secreta do cliente.
```
perl generate_user_credentials.pl -client_id {client_id} -client_secret {client_secret}
```
O exemplo solicita que você acesse um URL em que precisa 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/v2/auth?response_type=code&access_type=offline&client_id=...
```
Navegue até o URL em uma sessão de navegação particular ou 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.
Você será direcionado a uma página com uma mensagem indicando que a autorização foi bem-sucedida.
```
Authorization code was successfully retrieved.
```
O exemplo será concluído e seu token de atualização será exibido com algumas instruções na mesma página, seguido pelas propriedades necessárias para configurar a biblioteca de cliente:
```
Replace the following keys and values in your googleads.properties configuration file:

clientId==***********************apps.googleusercontent.com
clientSecret=****
refreshToken=****
```
Volte ao console em que você está executando o exemplo e pressione Ctrl + C para encerrar o processo. Em seguida, copie o token de atualização gerado com o ID e a chave secreta do cliente para o googleads.properties ou salve em outro lugar para usar se for instanciar a biblioteca no momento da execução.