Fluxos OAuth e de aplicativos da Web para OAuth

Este guia mostra como configurar o OAuth2 para acesso à API usando suas próprias credenciais e o fluxo da área de trabalho 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. Vincule todas as contas que você quer usar para fazer chamadas de API em uma única conta de administrador do Google Ads.

  2. Use o exemplo GenerateUserCredentials a fim de gerar credenciais OAuth2 para um usuário com acesso à conta de administrador.

  3. 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 concluídas uma vez, a menos que você revogue, exclua ou altere os escopos permitidos para as credenciais do 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 e volte a esta página.

Etapa 2: configurar a biblioteca de cliente

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

    Este é um exemplo interativo, que exigirá o fornecimento de entrada.

    dotnet run GenerateUserCredentials.csproj
    
  2. O exemplo solicita que você forneça o ID do cliente e o secret do OAuth2. Informe os detalhes da etapa 1.

  3. O exemplo abre um URL automaticamente no navegador. Se você não tiver feito login na sua sessão do navegador, a página da Web solicitará que você faça login na Conta do Google. Se você já tiver feito login, ele pulará a solicitação de login e redirecionará você para um URL em que é preciso autorizar o aplicativo a acessar sua conta do Google Ads em seu nome.

    Continuar com a tela de consentimento

  4. Você será direcionado a uma página com uma mensagem indicando que a autorização foi 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 você estava executando o exemplo. O exemplo deve ter sido concluído e estar exibindo o token de atualização e algumas instruções, seguidas pelas propriedades que você precisará 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 = '******' />
    
    <!-- Required for manager accounts only: Specify the login customer -->
    <!-- ID used to authenticate API calls. This will be the customer ID -->
    <!-- of the authenticated manager account. It should be set without -->
    <!-- dashes, for example: 1234567890 instead of 123-456-7890. You can -->
    <!-- also specify this later in code if your application uses -->
    <!-- multiple manager account OAuth pairs. -->
    <add key = 'LoginCustomerId' value = INSERT_LOGIN_CUSTOMER_ID_HERE />
    
    See 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 sabe com qual conta do Google Ads deve fazer chamadas de API com antecedência, pode encontrá-la no momento da execução usando as credenciais do usuário que fez login para a sessão. Consulte AuthenticateInAspNetCoreApplication para ver um exemplo de autenticação do usuário conectado e das credenciais OAuth2 no momento da execução.