Esta página foi traduzida pela API Cloud Translation.

Fluxos de aplicativos da Web e área de trabalho OAuth

Neste guia, explicamos como configurar o OAuth2 para acesso à API usando suas próprias credenciais e o fluxo para 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 é

Vincule todas as contas para as quais você quer fazer chamadas de API a 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 para todas as contas que você precisa gerenciar usando a API Google Ads.

Essas etapas só precisam ser concluídas 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 e 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 que requer o fornecimento de informações.
```
dotnet run GenerateUserCredentials.csproj
```
O exemplo solicita que você forneça o ID e a chave secreta do OAuth2. Informe os detalhes da etapa 1.
O exemplo 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 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 é necessário autorizar o aplicativo a acessar sua 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, esse é o e-mail de login de uma conta de administrador do Google Ads que contém todas as contas que você precisa gerenciar na hierarquia de contas.
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 para o console em que você estava executando o exemplo. O exemplo está completo e mostra o 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 do OAuth2 para aplicativos interativos

Se você não souber com antecedência a conta do Google Ads para a qual fazer chamadas de API, poderá descobri-la no tempo de execução usando as credenciais do usuário conectado na sessão. Consulte AuthenticateInAspNetCoreApplication para ver um exemplo em que o usuário conectado é autenticado e as credenciais do OAuth2 são recebidas no ambiente de execução.