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

As credenciais de acesso aos 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, permitindo que você gere tokens OAuth para gerenciar os usuários do Google Ads. O acesso às credenciais do Google OAuth2 é gerenciado no Console de APIs do Google.

Assista a este vídeo com algumas práticas recomendadas de projetos do Cloud

Verificação do Google OAuth

Qualquer app do Google Cloud usado para receber credenciais para o escopo da API Google Ads precisará passar por uma verificação do OAuth do Google para evitar uma tela da interface não verificada para os usuários. Um app, nesse contexto, é definido como um ID do cliente OAuth 2.0 exclusivo no Google Cloud.

Essa verificação é independente e complementa as revisões realizadas como parte do processo de aprovação do token de desenvolvedor. Ela é obrigatória porque o escopo da API Google Ads é um escopo sensível.

Não há custo para a verificação do Google, que normalmente é concluída em três a cinco dias úteis. Esta política se aplica a todos os apps.

Recomendamos que todos os apps passem pelo processo de verificação do Google OAuth o mais rápido possível para evitar interrupções nos negócios.

Criar um projeto

Vá para o Console de APIs 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:

  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 usuário e um status de publicação

Depois de ativar a API, especifique o Tipo de usuário e o Status de publicação do projeto. A tabela a seguir destaca alguns dos principais atributos e limitações de cada combinação dessas configurações. Para mais detalhes, consulte a documentação do Google Cloud Platform.

Tipo de usuário Status de publicação Limitações
Internos Teste
  • Disponível apenas para projetos associados a uma organização do Google Cloud.
  • Limitado a até 100 usuários de teste listados na tela de permissão OAuth.
  • Os usuários de teste precisam ser internos na organização do Google Cloud associada ao projeto.
  • As autorizações expiram sete dias após o consentimento.
External Teste
  • Disponível para todos os projetos.
  • Limitado a até 100 usuários de teste listados na tela de permissão OAuth.
  • Os usuários de teste podem ser qualquer usuário com uma Conta do Google.
  • As autorizações expiram sete dias após o consentimento.
Internos Em produção
  • Disponível apenas para projetos associados a uma organização do Google Cloud.
  • Permite autorizar qualquer usuário na organização do Google Cloud associada ao projeto.
External Em produção
  • Disponível para todos os projetos.
  • Permite autorizar qualquer usuário com uma Conta do Google.

Não concluir a verificação do Google OAuth resulta nos seguintes resultados, independentemente do Tipo de usuário ou do Status de publicação do seu projeto:

  1. Abra a página de permissão e selecione seu projeto no menu suspenso na parte de cima da página.

  2. Selecione o Tipo de usuário e clique em CRIAR.

  3. Preencha o formulário da tela de consentimento. É possível editar isso mais tarde, se necessário. Clique em SALVAR E CONTINUAR quando terminar.

  4. Na próxima página, clique em ADICIONAR OU REMOVER ESCOPOS.

    • Role para baixo e insira o seguinte no campo em Adicionar escopos manualmente:

      https://www.googleapis.com/auth/adwords
      
    • Clique em ADICIONAR À TABELA.

    • Adicione outros escopos solicitados pelo seu projeto e clique em ATUALIZAR.

    • Clique em SALVAR E CONTINUAR.

  5. Se você não pretende publicar seu projeto imediatamente, adicione o endereço de e-mail de cada conta de usuário que será usada no teste e clique em SALVAR E CONTINUAR.

  6. Revise a página de resumo e clique em VOLTAR PARA O PAINEL.

Depois de testar o aplicativo e o processo de autorização, volte ao painel e clique em PUBLICAR APP para alterar o Status de publicação de Teste para Em produção.

Selecione um tipo de app

Há duas opções de tipo de aplicativo para a API Google Ads: para computador ou para a Web. Consulte a tabela abaixo para determinar qual tipo é mais adequado para o app que você quer criar:

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

Para mais detalhes, consulte a documentação do OAuth da 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 aplicativo, siga as instruções abaixo para gerar o ID e a chave secreta do cliente do 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 permissão OAuth para o projeto, vamos redirecionar você para 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. É possível editar isso mais tarde, se necessário. 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 caso de uso.

  4. Dê 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 vai usar um redirecionamento de IP de loopback, mas o URI não estará configurado explicitamente no Console do Cloud.

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