Esta página foi traduzida pela API Cloud Translation.

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 precisam ser concluídas apenas uma vez, a menos que você revogue, exclua ou altere os escopos permitidos para as credenciais do OAuth2.

Etapa 1: 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 e volte a esta página.

Etapa 2: configurar 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. Você pode modificar os 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 precisa 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/v2/auth?response_type=code&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.
Você será direcionado a uma página com uma mensagem indicando que a autorização foi concluída.
```
Authorization code was successfully retrieved.
```
Você verá que o exemplo foi concluído e que seu token de atualização é exibido com algumas instruções na mesma página, seguidos 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 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 seu googleads.properties ou salve-o em outro lugar para usar ao instanciar a biblioteca no momento da execução.