Fluxos de aplicativos da Web e área de trabalho OAuth

Neste guia, mostramos como configurar o OAuth2 para acesso à API usando suas próprias credenciais e o fluxo para computadores ou o fluxo da Web. Essas etapas só precisam ser seguidas 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. Faça o download do arquivo JSON do cliente clicando primeiro no ícone Fazer o download do cliente OAuth e, em seguida, no botão FAZER O DOWNLOAD do JSON na tela a seguir.

    Salve o arquivo no diretório principal para ter o arquivo local ~/client_secret_XXX.apps.googleusercontent.com.json (em que XXX serão valores específicos do projeto). Usaremos esse arquivo na próxima etapa para executar o exemplo de código.

Configure a biblioteca de cliente.

  1. Em um terminal, execute o exemplo generate_user_credentials. Use sinalizações de linha de comando para passar o arquivo JSON que você salvou na etapa anterior.

    generate_user_credentials.py \
      --client_secrets_path=${HOME}/client_secret_XXX.apps.googleusercontent.com.json
    
  2. 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/auth?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.

    Tela de consentimento

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

    Seu token de atualização foi buscado. Verifique a saída do console para mais instruções.

  4. Retorne ao console em que você executou o exemplo, que agora deve exibir seu token de atualização e algumas instruções para configurar a biblioteca de cliente:

    Your refresh token is: 1/Yw.........................................
    Add your refresh token to your client library configuration as described here:
    https://developers.google.com/google-ads/api/docs/client-libs/python/configuration