Este guia ensina a configurar o OAuth 2.0 para acesso à API usando suas próprias credenciais e o fluxo para computador ou o fluxo para Web. Essas etapas só precisam ser realizadas 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
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 do cliente e volte a esta página.
Configure a biblioteca de cliente.
-
Em um terminal, execute o exemplo
GenerateUserCredentials
. Insira o ID e a chave secreta do cliente OAuth 2.0 quando solicitado.dotnet run GenerateUserCredentials.csproj
Este exemplo de código abre um URL automaticamente no navegador. Se você não tiver feito login na sessão do navegador, a página da Web vai solicitar que você faça login na sua Conta do Google. Se você já tiver feito login, a solicitação de login será ignorada e você será redirecionado para um URL em que precisará autorizar o app a acessar sua conta do Google Ads em seu nome.
Faça login com a Conta do Google que você usa para acessar o Google Ads. Normalmente, é um e-mail de login para uma conta de administrador do Google Ads que contém todas as contas que você precisa gerenciar na hierarquia. Clique em Continuar na tela de consentimento do OAuth 2.0.
Você vai ser direcionado a uma página com uma mensagem indicando que a autorização foi concluída.
Your refresh token has been fetched. Check the console output for further instructions.
Volte para o console em que você está executando o exemplo de código. 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:
Copy the following content into your
App.config
file. <add key = 'OAuth2Mode' value = 'APPLICATION' /> <add key = 'OAuth2ClientId' value = '******' /> <add key = 'OAuth2ClientSecret' value = '******' /> <add key = 'OAuth2RefreshToken' value = '******' />Defina também o cabeçalho
LOGIN_CUSTOMER_ID
no arquivoApp.config
. Consulte o guia de configuração para saber mais.<add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />
Consulte o guia de configuração para conferir outras opções de configuração.
Gerar credenciais OAuth2 para aplicativos interativos
Se você não souber qual é a conta do Google Ads para fazer chamadas de API, é possível
descobrir isso no momento da execução usando as credenciais do usuário conectado para a
sessão. Consulte
AuthenticateInAspNetCoreApplication
para conferir um exemplo em que o usuário conectado é autenticado e as credenciais do OAuth2
são obtidas no momento da execução.