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

  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 volte a esta página.

Etapa 2: configurar a biblioteca de cliente

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

  2. 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}
    
  3. 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.

    Continuar com a tela de consentimento

  4. 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=****
    
  5. 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.