Fluxos de aplicativos da Web e área de trabalho OAuth

Este guia mostra como configurar o OAuth 2.0 para acesso à API usando suas próprias credenciais e o fluxo de trabalho para computador ou o fluxo de trabalho da Web. Essas etapas só precisam ser seguidas uma vez, a menos que você revogue, exclua ou precise mudar os escopos permitidos para suas credenciais do OAuth 2.0.

Criar credenciais do OAuth 2.0

  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 do cliente e volte para esta página.

Configure a biblioteca de cliente.

  1. Em um terminal, execute o exemplo generate_user_credentials.pl. É possível modificar os valores de INSERT_XXX_HERE no exemplo antes de executar ou usar os argumentos de linha de comando -client_id para ID do cliente e -client_secret para chave secreta do cliente.

    perl generate_user_credentials.pl -client_id {client_id} -client_secret {client_secret}

  2. Este exemplo de código pede que você acesse um URL em que é necessário autorizar o app a acessar 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 de navegação anônima ou em uma janela anônima. Faça login com a Conta do Google que você usa para acessar o Google Ads. Normalmente, esse é um e-mail de login de uma conta de administrador do Google Ads que contém todas as contas que você precisa gerenciar na hierarquia dela. Clique em Continuar na tela de permissão do OAuth 2.0.

    Tela de permissão do OAuth 2.0

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

    Authorization code was successfully retrieved.

  3. Volte ao console em que você está executando o exemplo de código. Você vai notar que o exemplo de código foi concluído e está mostrando seu token de atualização e algumas instruções, seguidas pelas instruções que você precisa seguir para configurar a biblioteca de cliente:

    Replace the following keys and values in your googleads.properties configuration file:

clientId==***********************apps.googleusercontent.com
clientSecret=****
refreshToken=****

  4. 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 no arquivo googleads.properties ou salve em outro lugar para usar ao instanciar a biblioteca em tempo de execução.