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

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

As credenciais para acessar os servidores OAuth2 do Google são necessárias para autenticar e autorizar os 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 ver algumas práticas recomendadas para projetos do Cloud.

Criar um projeto

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

Ativar a API Google Ads no seu projeto

Para ativar a API Google Ads no seu projeto, siga estas etapas:

  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 app

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

  • Apps para computador
  • Apps da Web

Confira 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ê está gerenciando todas as suas contas do Google Ads usando uma única conta de administrador de nível superior.
  • Você é um usuário iniciante ou quer começar rapidamente com uma configuração mais simples.
  • Seu app só autentica os usuários do Google em uma máquina.
App da Web
  • Você quer se autenticar como um usuário que pode conceder permissão ao seu app para acessar os dados da conta dele 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 Google Identity Platform para apps para computador ou apps da Web.

Criar um ID e uma chave secreta do cliente

Depois de determinar o tipo de app, 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 tiver configurado uma tela de permissão OAuth para o projeto, receberá instruções para fazer isso agora. Clique em CONFIGURAR TELA DE CONSENTIMENTO.

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

      2. Preencha o formulário inicial. É possível editar isso mais tarde, se necessário. Clique em Salvar quando terminar.

    2. Navegue até Credenciais > CRIAR CREDENCIAIS > ID do cliente OAuth para continuar.

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

  4. Escolha 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 fazer 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 está configurado explicitamente no console do Cloud.

  6. Na página de confirmação, copie Seu ID do cliente e Sua chave secreta do cliente para a área de transferência, porque eles serão necessários durante a configuração da sua biblioteca de clientes. Também é possível retornar à página de credenciais mais tarde para recuperar esses detalhes.