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, permitindo que você gere 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 para projetos do Cloud

Verificação do Google OAuth

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

Essa verificação é independente e complementa todas as avaliaçõ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á custos 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 OAuth do Google assim que 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.

Importante: se o faturamento estiver ativado para o Google Cloud, por exemplo, você precisará selecionar uma conta de faturamento para o novo projeto.

O uso da API Google Ads não é cobrado. No entanto, há uma cota para o número total de projetos do Cloud. Como alternativa, inscreva-se em uma nova Conta do Google que inclua uma cota sem custo financeiro de projeto.

Ativar a API Google Ads no seu projeto

Para ativar a API Google Ads no 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 usuário e o status de publicação

Depois de ativar a API, especifique o Tipo de usuário e o Status da 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
Interno	testes	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 do OAuth. Os usuários de teste precisam ser internos na organização do Google Cloud associada ao projeto. As autorizações expiram sete dias a partir do momento do consentimento.
Serviço	testes	Disponível para todos os projetos. Limitado a até 100 usuários de teste listados na tela de permissão do OAuth. Os usuários de teste podem ser qualquer usuário com uma Conta do Google. As autorizações expiram sete dias a partir do momento do consentimento.
Interno	Em produção	Disponível apenas para projetos associados a uma organização do Google Cloud. Permite autorizar qualquer usuário da organização do Google Cloud associada ao projeto.
Serviço	Em produção	Disponível para todos os projetos. Permite autorizar qualquer usuário com uma Conta do Google.

Se você não concluir a verificação do OAuth do Google, isso resultará no seguinte, independente do Tipo de usuário ou Status de publicação do projeto:

• Durante o processo de autorização, os usuários veem uma tela de interface não verificada.

• Você está limitado a autorizar apenas 100 usuários.

Configurar a tela de permissão OAuth

1. Abra a página Tela de consentimento 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 os outros escopos solicitados pelo 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 usará para o teste e clique em SALVAR E CONTINUAR.

6. Revise a página de resumo e clique em VOLTAR AO 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 app para a API Google Ads: computador ou Web. Consulte a tabela abaixo para determinar o 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ê for um usuário iniciante ou quiser começar rapidamente com a configuração mais simples. O app autenticará os usuários do Google somente em uma máquina.
App da Web	Você quer autenticar como um usuário que pode conceder permissão ao seu app para acessar os dados da conta do Google Ads dele. 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 têm suporte no fluxo de apps para computador.

Importante: ainda é possível escolher o fluxo de apps para computador mesmo que você esteja desenvolvendo um app para execução em um servidor. A diferença é se a autorização OAuth é concluída local ou remotamente. Um fluxo de desktop requer que a autorização seja concluída na máquina local, enquanto o fluxo da Web permite que a autorização seja concluída no servidor de autorização do Google.

Para mais detalhes, consulte a documentação do OAuth do Google Identity Platform sobre 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 o ID do cliente do OAuth.

   1. Se você ainda não tiver configurado uma tela de permissão OAuth para o projeto, vamos direcionar você 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. 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. Forneça 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 em nossos exemplos de biblioteca de cliente, use http://127.0.0.1.

   Observação: é possível adicionar um número de porta ao URI de redirecionamento para restringir o uso a uma porta específica. Se a porta não estiver definida, um cliente OAuth poderá redirecionar para qualquer porta.

   Para clientes de apps para computador, você ainda vai usar um redirecionamento de IP de loopback, mas o URI não é 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 você precisará deles ao configurar a biblioteca de cliente. Você também pode retornar à página de credenciais mais tarde para recuperar esses detalhes.