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, 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 ver algumas práticas recomendadas para projetos do Cloud.
Verificação do Google OAuth
Qualquer app do Google Cloud usado para receber credenciais do escopo da Google Ads API precisará passar por uma verificação do Google OAuth para evitar uma tela de IU não verificada para os usuários. Um app, neste contexto, é definido como um ID do cliente OAuth 2.0 exclusivo no Google Cloud.
Essa verificação é independente e faz parte de todas as revisões realizadas como parte do processo de aprovação do token de desenvolvedor. Ela é necessá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 OAuth do Google 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, 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 o 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.
Escolha um tipo de usuário e um status de publicação
Em seguida, especifique o Tipo de usuário e o Status de publicação do projeto. A tabela a seguir destaca alguns atributos e limitações importantes 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 | Teste |
|
Externo | Teste |
|
Interno | Em produção |
|
Externo | Em produção |
|
Não concluir a verificação do OAuth do Google resultará no seguinte, independentemente do tipo de usuário ou do status de publicação do projeto:
Durante o processo de autorização, os usuários veem uma tela de IU não verificada.
Você só pode autorizar 100 usuários.
Configurar a tela de permissão OAuth
Abra a página Tela de consentimento e selecione seu 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 SALVAR E CONTINUAR quando terminar.
Na próxima página, clique em ADICIONAR OU REMOVER ESCOPOS.
Role para baixo e digite o seguinte no campo em Add manually scopes:
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.
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 para teste e clique em SALVAR E CONTINUAR.
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 mudar 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 a seguir para determinar o 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 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:
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ê 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.
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.
Navegue até Credenciais > CRIAR CREDENCIAIS > ID do cliente OAuth para continuar.
Selecione App para computador ou Aplicativo da Web como tipo de app, dependendo do caso de uso.
Escolha um nome e clique em Criar.
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.
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.