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.
Gerar credenciais do OAuth2 para uma única conta
A maneira mais fácil de fazer chamadas para contas da API Google Ads é
vincular todas as contas que você quer que recebam chamadas de API em uma única conta de administrador do Google Ads.
Use o exemplo
GenerateUserCredentials
para gerar credenciais do OAuth2 para um usuário com acesso à conta de administrador.Use as credenciais do OAuth2 para fazer chamadas a todas as contas que você precisa gerenciar usando a API Google Ads.
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.
Etapa 1: criar credenciais do OAuth2
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, depois volte para esta página.
Etapa 2: configurar a biblioteca de cliente
Em um terminal, execute o exemplo
GenerateUserCredentials
, que solicita o ID e a chave secreta do cliente OAuth2.Este é um exemplo interativo, em que você precisará fornecer entradas.
dotnet run GenerateUserCredentials.csproj
O exemplo solicita que você forneça o ID do cliente e o secret do OAuth2. Forneça os detalhes da etapa 1.
O exemplo abre um URL automaticamente no navegador. Se você não estiver conectado à sessão do navegador, a página da Web solicitará que você faça login na Conta do Google. Se você já estiver conectado, a solicitação de login será ignorada e você será redirecionado para um URL em que é solicitado que autorize o aplicativo a acessar a conta do Google Ads em seu nome.
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.
Volte ao console em que o exemplo estava sendo executado. O exemplo deve ter sido concluído e exibir seu token de atualização e algumas instruções, seguidos pelas propriedades necessárias 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 = '******' /> Make sure you also set the LOGIN_CUSTOMER_ID header. See https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration#google_ads_api_settings to learn more. <add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' /> See https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration for alternate configuration options.
Gerar credenciais OAuth2 para aplicativos interativos
Se você não souber com antecedência a conta do Google Ads que receberá chamadas de API, poderá descobri-la no tempo de execução usando as credenciais do usuário conectado na sessão. Consulte
AuthenticateInAspNetCoreApplication
para conferir um exemplo em que o usuário conectado é autenticado e as credenciais
OAuth2 são recebidas no ambiente de execução.