Fluxos de aplicativos da Web e área de trabalho OAuth

Aviso:a partir da versão 19.0.0, o A biblioteca de cliente da API Google Ads para .NET não são mais compatíveis com .NET 5.0. Para garantir uma operação perfeita, é altamente recomendável atualizar sua versão do .NET antes do final de 2024.

Este guia explica como configurar o OAuth2 para acesso à API usando seu próprio credenciais e o fluxo de computador 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 é

1. Vincular todas as contas para as quais você quer fazer chamadas de API em um único Conta de administrador do Google Ads.

2. Usar o GenerateUserCredentials exemplo para gerar credenciais do OAuth2 para um usuário com acesso ao gerenciador do Compute Engine.

3. Use as credenciais do OAuth2 para fazer chamadas a todas as contas de 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 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, depois volte para esta página.

Etapa 2: configurar a biblioteca de cliente

1. Em um terminal, execute o comando GenerateUserCredentials , que solicita o ID e a chave secreta do cliente OAuth2.

   Este é um exemplo interativo, em que você precisará fornecer entrada.

   dotnet run GenerateUserCredentials.csproj
   

2. O exemplo solicita que você forneça o ID do cliente e o secret do OAuth2. Forneça os detalhes da etapa 1.

3. O exemplo abre um URL automaticamente no navegador. Se você não tiver assinado à sessão do navegador, a página da Web solicitará que você faça login no Conta do Google. Caso já tenha feito isso, o login será ignorado e redireciona para um URL onde é solicitado que você autorize o para acessar a conta do Google Ads em seu nome.

   Observação :faça login com a mesma Conta do Google que você usa para acessar o Google Ads. Geralmente, é um e-mail de login em uma conta de administrador do Google Ads que contém todas as contas que você precisa gerenciar na hierarquia de contas.

   

4. Em seguida, você é direcionado para uma página com uma mensagem indicando que o autorização concluída.

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

5. Volte ao console em que o exemplo estava sendo executado. O exemplo deve foram concluídos e estão exibindo seu token de atualização e algumas instruções, seguida 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 conhece a conta do Google Ads à qual fazer chamadas de API com antecedência, pode no ambiente de execução usando as credenciais do usuário conectado para o sessão. Consulte AuthenticateInAspNetCoreApplication um exemplo em que o usuário conectado está autenticado e o OAuth2 as credenciais são recebidas no ambiente de execução.