Configurar um projeto do Console de APIs do Google para a API Google Ads

As credenciais para acessar os servidores OAuth2 do Google são necessárias para autenticar e autorizar usuários do Google Ads. Essas credenciais identificam seu app para o Google e permitem gerar tokens OAuth para gerenciar usuários do Google Ads. O acesso às credenciais do Google OAuth2 é gerenciado no Console de APIs do Google.

Assista a este vídeo para conhecer algumas práticas recomendadas do projeto do Cloud

Criar um projeto

Vá para o Console de API do Google. Clique em Criar projeto, digite um nome e clique em Criar.

Ativar a API Google Ads no seu projeto

Para ativar a API Google Ads no seu projeto, faça o seguinte:

  1. Abra a biblioteca de APIs no Console de APIs do Google. Se solicitado, selecione o projeto ou crie um novo. A biblioteca de APIs lista todas as APIs disponíveis agrupadas por família de produtos e popularidade.

  2. Use a pesquisa para encontrar a API Google Ads se ela não estiver visível na lista.

  3. Selecione a API Google Ads e clique no botão Ativar.

Escolher um tipo de aplicativo

Há duas opções de tipo de aplicativo para a Google Ads API:

  • Apps para computador
  • Apps da Web

Consulte a tabela abaixo para determinar qual tipo é mais apropriado para o app que você quer criar:

Escolha este tipo de aplicativo Se...
App para computador
  • Você gerencia todas as suas contas do Google Ads com uma única conta de administrador de nível superior.
  • Você é um usuário iniciante ou quer começar rapidamente com a configuração mais simples.
  • O app só autenticará usuários do Google em uma máquina.
App da Web
  • Você quer autenticar como um usuário que pode conceder permissão para que seu aplicativo acesse os dados da conta do Google Ads.
  • Você quer gerar facilmente várias credenciais de autorização para gerenciar contas de terceiros, por exemplo.
  • Seu app exige URLs de callback, que não são compatíveis com o fluxo de apps para computador.

Para mais detalhes, consulte a documentação do OAuth da plataforma de identidade do Google para apps para computador ou apps da Web.

Criar um ID e uma chave secreta do cliente

Depois de determinar o tipo de aplicativo, siga as instruções abaixo para gerar a chave secreta e o ID do cliente OAuth2:

  1. Abra a página Credenciais. Selecione um projeto criado anteriormente ou crie um novo.

  2. Na tela "Credenciais", clique em CRIAR CREDENCIAIS e selecione ID do cliente OAuth.

    1. Se você ainda não configurou uma tela de consentimento do OAuth para este projeto, agora será necessário fazer isso. Clique em CONFIGURAR TELA DE CONSENTIMENTO.

      1. Selecione o tipo de usuário e clique em CRIAR.

      2. Preencha o formulário inicial. Se necessário, você poderá editá-la mais tarde. Clique em Salvar quando terminar.

    2. Volte para Credenciais > CRIAR CREDENCIAIS > ID do cliente OAuth para continuar.

  3. Selecione App para computador ou Aplicativo da Web como o tipo de app, dependendo do seu caso de uso.

  4. Atribua um nome e clique em Criar.

  5. Se o tipo de cliente for Aplicativo da Web, adicione pelo menos um URI de redirecionamento autorizado.

    Para testes locais compatíveis com a configuração padrão nos exemplos da biblioteca de cliente, use http://127.0.0.1.

    Para clientes de app para computador, você ainda usará um redirecionamento de IP de loopback, mas o URI não é explicitamente configurado no Console do Cloud.

  6. Na página de confirmação, copie o ID do cliente e a chave secreta do cliente para a área de transferência, porque eles serão necessários quando você configurar sua biblioteca de cliente. Você também pode retornar à página de credenciais posteriormente para recuperar esses detalhes.