Você precisa de um projeto no Console de APIs do Google para criar credenciais do OAuth 2.0, configurar uma tela de consentimento do usuário e ativar a API Google Ads no seu aplicativo.
As credenciais são necessárias para a autenticação e a autorização de usuários do Google Ads pelos servidores do Google. Essas credenciais permitem gerar tokens OAuth para serem usados em chamadas para a API.
Selecionar ou criar um projeto do Console de APIs do Google
Se você já tiver um projeto no Console de APIs do Google e quiser usá-lo para criar credenciais, pule para Criar um ID e uma chave secreta do cliente.
Para criar um projeto,
- Acesse o Console de APIs do Google.
- Clique em Criar projeto.
- Insira um nome ou aceite a sugestão gerada
- Confirme ou edite os campos restantes
- Clique em Create.
Se o faturamento estiver ativado, selecione uma conta de faturamento para o novo projeto. Não há cobrança pelo uso da API Google Ads, mas há uma cota para o número total de projetos do Cloud.
Configurar a tela de permissão OAuth
Se você estiver usando um projeto existente do Console de APIs do Google e tiver configurado uma tela de permissão OAuth antes, pule esta etapa e modifique sua tela de consentimento adicionando o escopo do OAuth 2.0 da Google Ads API.
Quando você usa o OAuth 2.0 para autorização, o Google exibe uma tela de consentimento ao usuário, incluindo um resumo do projeto, as políticas dele e os escopos de acesso da autorização solicitada. A configuração da tela de permissão OAuth do app define o que é exibido aos usuários e revisores e registra o app para que você possa publicá-lo mais tarde.
Configurar uma nova 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 Adicionar escopos manualmente:
https://www.googleapis.com/auth/adwords - Clique em ADICIONAR À TABELA.
- Adicione quaisquer outros escopos de que seu projeto possa precisar 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 possa ser usada para testes e clique em SALVAR E CONTINUAR.
- Revise a página de resumo e clique em VOLTAR AO PAINEL.
Configurar uma tela de permissão OAuth atual
- Abra a página Tela de consentimento e selecione o projeto no menu suspenso na parte de cima da página.
- Clique em EDITAR APP.
- Clique em SALVAR E CONTINUAR no formulário da tela de consentimento do OAuth.
- Na próxima página, clique em ADICIONAR OU REMOVER ESCOPOS.
- Role para baixo e digite o seguinte no campo em Adicionar escopos manualmente:
https://www.googleapis.com/auth/adwords - Clique em ADICIONAR À TABELA.
- Clique em SALVAR E CONTINUAR.
- Clique em SALVAR E CONTINUAR no formulário Usuários de teste.
- Revise a página de resumo e clique em VOLTAR AO PAINEL.
Criar um ID e uma chave secreta do cliente
Pule esta etapa se estiver usando um projeto do Console de APIs do Google que já tenha um ID do cliente e uma chave secreta gerados.
Depois de determinar o tipo de app, siga as instruções abaixo para gerar o ID e a chave secreta do cliente do OAuth 2.0:
Abra a página Credenciais. Selecione um projeto criado anteriormente ou crie um novo.
Na tela "Credenciais", clique em CRIAR CREDENCIAIS e selecione o ID do cliente do OAuth.
Se você ainda não configurou uma tela de consentimento OAuth para o projeto, 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 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. Este guia usa App para computador como o tipo de aplicativo.
Insira um nome para o app e clique em Criar.
Na página de confirmação, copie Seu ID do cliente e Sua chave secreta do cliente para a área de transferência para configurar a biblioteca de cliente mais tarde. Além disso, faça o download das credenciais no formato JSON para um arquivo chamado
credentials.json.
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.