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 concluídas apenas uma vez, a menos que você revogue, exclua ou precise alterar os escopos permitidos para suas 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. Anote o ID do cliente e a chave secreta e depois volte para esta página.

Configure a biblioteca de cliente.

  1. Em um terminal, navegue até o exemplo do OAuth2.

  2. Execute este exemplo usando a linha de comando. É possível 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}
    
  3. O exemplo solicita que você acesse um URL em que 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/v2/auth?response_type=code&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

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

    Authorization code was successfully retrieved.
    

    Você verá que o exemplo foi concluído e o token de atualização foi exibido com algumas instruções na mesma página, seguidas 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=****
    
  5. Volte para o 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 no googleads.properties ou salve-o em outro lugar para usar se você instanciar a biblioteca no momento da execução.