As credenciais para acessar os servidores OAuth2 do Google são necessárias para autenticam e autorizam usuários do Google Ads. Essas credenciais identificam seus app para o Google, permitindo que você gere tokens OAuth para gerenciar o Google Ads usuários. 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
Todos os apps do Google Cloud usados para receber credenciais para o escopo da API Google Ads precisam passar por uma solicitação de serviço OAuth do Google a verificação para evitar uma tela de interface não verificada para usuários. Nesse contexto, um app é definido como um ID do cliente OAuth 2.0 exclusivo. no Google Cloud.
Essa verificação é independente e além das análises realizadas como parte do processo de aprovação do token de desenvolvedor, e é obrigatório, pois o escopo da API do Google Ads é confidencial do projeto.
Não há custo para a verificação do Google, que geralmente é concluída entre 3 e 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.
Ativar a API Google Ads no seu projeto
Para ativar a API Google Ads no projeto, siga estas etapas:
Abra a Biblioteca de APIs no Console de APIs do Google. Se solicitado, selecione o ou criar um novo. A Biblioteca de APIs lista todas as APIs APIs, 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 o status de publicação
Depois de ativar a API, especifique o Tipo de usuário e Status da publicação. A tabela a seguir destaca alguns dos principais atributos e as limitações de cada combinação dessas configurações. Para mais detalhes, consulte pela Google Cloud Platform Documentação.
| Tipo de usuário | Status de publicação | Limitações |
|---|---|---|
| Interno | Teste |
|
| Externo | Teste |
|
| Interno | Em produção |
|
| Externo | Em produção |
|
Não concluir a solicitação de OAuth do Google verificação resulta no seguinte, independentemente do Tipo de usuário ou da Publicação status do seu projeto:
Durante o processo de autorização, os usuários recebem uma interface não verificada tela.
Você está limitado a autorizar apenas 100 usuários.
Configurar a tela de permissão OAuth
Abra o página "Tela de consentimento", e selecione o projeto no menu suspenso na parte superior 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 Quando terminar, clique em SALVAR E CONTINUAR.
Na próxima página, clique em ADICIONAR OU REMOVER ESCOPOS.
Role para baixo e digite o seguinte no campo em Adicionar manualmente escopos:
https://www.googleapis.com/auth/adwordsClique em ADICIONAR À TABELA.
Adicione os outros escopos solicitados pelo projeto e clique em ATUALIZAR.
Clique em SALVAR E CONTINUAR.
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 nos testes, clique em SALVAR E CONTINUAR.
Revise a página de resumo e clique em VOLTAR AO PAINEL.
Depois de testar seu aplicativo e o processo de autorização, você pode retorne ao painel e clique em PUBLICAR APP para alterar a seção Publicação Status 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 a seguir para determinar o tipo mais apropriado para o aplicativo que você quer para criar:
| Escolha este tipo de aplicativo | Se... |
|---|---|
| App para computador |
|
| App da Web |
|
Confira mais detalhes na documentação do OAuth do 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 do seu aplicativo, siga as instruções abaixo para gerar o ID e a chave secreta do cliente OAuth2:
Abra a página Credenciais. Selecione um projeto criado anteriormente ou crie um novo.
Na tela "Credenciais", clique em CRIAR CREDENCIAIS e selecione OAuth ID do cliente.
Se você não tiver configurado uma tela de permissão OAuth para o projeto anteriormente, você será instruído a 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 Clique em Salvar quando terminar.
Volte para 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.
Forneça um nome e clique em Criar.
Caso seu tipo de cliente seja aplicativo da Web, adicione pelo menos um URI de redirecionamento.
Para testes locais compatíveis com a configuração padrão em nossa exemplos de biblioteca de cliente, use
http://127.0.0.1.Para clientes de apps para computador, você ainda 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, já que você vai precisar delas para configurar o cliente biblioteca. Você também pode retornar à página de credenciais mais tarde para recuperá-las detalhes.
