Esta página foi traduzida pela API Cloud Translation.

Fluxos de aplicativos da Web e área de trabalho OAuth

Este guia explica como configurar o OAuth2 para acesso à API usando seu suas próprias credenciais e a configuração "Desktop" fluxo ou a Web fluxo. Você só precisa concluir essas etapas uma vez, a menos que você revogue, exclua ou precise alterar os escopos permitidos para suas credenciais do OAuth2.

Criar credenciais do 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 a chave secreta, depois volte para esta página.

Configure a biblioteca de cliente.

Em um terminal, navegue até o exemplo do OAuth2.
- generate_user_credentials.pl
Execute este exemplo usando a linha de comando. É possível modificar Valores INSERT_XXX_HERE no exemplo antes de executar 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 será necessário permitir que o credenciais do OAuth2 para acessar a 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=...
```
Acesse o URL em uma sessão particular de 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 consentimento do OAuth2.
Em seguida, você é direcionado para uma página com uma mensagem indicando que o autorização concluída.
```
Authorization code was successfully retrieved.
```
Você verá que o exemplo foi concluído e seu token de atualização será exibido com algumas instruções na mesma página, seguidas pelas propriedades que você vai precisar 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 junto com o ID e a chave secreta do cliente em googleads.properties ou salve-os em outro lugar para usar se instanciar a biblioteca no tempo de execução.