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 aplicativo 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 aplicativo 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 IU não verificada para os usuários. Nesse contexto, um app é definido como um ID do cliente OAuth 2.0 exclusivo no Google Cloud.
Essa verificação é independente e obrigatória para o processo de aprovação do token de desenvolvedor, já que 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. Essa política se aplica a todos os apps.
Recomendamos que todos os apps passem pelo processo de verificação do Google OAuth o quanto antes para evitar interrupções nos negócios.
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:
Abra a biblioteca de APIs no Console de APIs do Google. Se solicitado, selecione seu projeto ou crie um novo. A Biblioteca de APIs lista todas as APIs disponíveis, agrupadas por família de produtos e popularidade.
Use a pesquisa para encontrar a API Google Ads, se ela não estiver visível na lista.
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 | testes |
|
Externos | testes |
|
Internos | Em produção |
|
Externos | Em produção |
|
Não concluir a verificação do Google OAuth resulta no seguinte, independentemente do Tipo de usuário ou do Status de publicação do seu projeto:
Durante o processo de autorização, uma tela de interface não verificada é exibida aos usuários.
Você tem um limite de 100 usuários.
Configurar a tela de permissão OAuth
Abra a página de consentimento e selecione seu projeto no menu suspenso na parte de cima da página.
Selecione o Tipo de usuário e clique em CRIAR.
Preencha o formulário da tela de consentimento. É possível editar isso mais tarde, se necessário. Clique em SALVAR E CONTINUAR quando terminar.
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 que seu projeto solicitará e clique em ATUALIZAR.
Clique em SALVAR E CONTINUAR.
Se você não planeja 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.
Analise 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 Web. Consulte a tabela a seguir para determinar qual tipo é mais apropriado para o app que você quer criar:
Escolha este tipo de aplicativo | Se... |
---|---|
App para computador |
|
App da Web |
|
Para mais detalhes, consulte a documentação do OAuth do Google Identity Platform para aplicativos 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:
Abra a página Credenciais. Selecione um projeto criado anteriormente ou crie um novo.
Na tela "Credenciais", clique em CRIAR CREDENCIAIS e selecione ID do cliente OAuth.
Se você não tiver configurado uma tela de permissão OAuth para o projeto anteriormente, será direcionado para fazer isso agora. Clique em CONFIGURAR TELA DE CONSENTIMENTO.
Selecione o tipo de usuário e clique em CRIAR.
Preencha o formulário inicial. É possível editar isso mais tarde, se necessário. Clique em Salvar quando terminar.
Volte até Credenciais > CRIAR CREDENCIAIS > ID do cliente OAuth para continuar.
Selecione App para computador ou Aplicativo da Web como o tipo de app, dependendo do caso de uso.
Dê um nome e clique em Criar.
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 apps para computador, você ainda vai usar um redirecionamento de IP de loopback, mas o URI não está configurado explicitamente no Console do Cloud.
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 ao configurar sua biblioteca de cliente. Também é possível retornar à página de credenciais mais tarde para recuperar esses detalhes.