Resumo
Você precisa solicitar um token de desenvolvedor e receber credenciais de autenticação para usar a API Google Ads e fazer chamadas de API em uma conta do Google Ads. Consulte o Guia de início rápido para mais detalhes.
Etapas manuais
Para usar a API Google Ads, siga estas etapas:
Receber um token de desenvolvedor
Um token de desenvolvedor do Google Ads conecta seu app à API Google Ads.
- Siga as etapas em Receber seu token de desenvolvedor.
- Após a inscrição, seu token estará com aprovação pendente.
- Verifique se o software está em conformidade com os Termos e Condições (T&C) da API Google Ads e os recursos mínimos obrigatórios (RMF, na sigla em inglês). Os RMF só são obrigatórios para tokens com acesso padrão.
Você pode recuperar o token de desenvolvedor da sua conta de administrador a qualquer momento na interface do Google Ads, em FERRAMENTAS E CONFIGURAÇÕES > CONFIGURAÇÃO > Central de API.
Você pode usar seu token de desenvolvedor imediatamente com uma conta de administrador de teste. Seu token de desenvolvedor precisa ser aprovado para que você possa usá-lo com contas de produção do Google Ads.
A API oferece os seguintes níveis de acesso:
- Teste
- Básico
- Padrão
Consulte Níveis de acesso e uso permitido para mais informações sobre cada nível.
Criar contas de teste
As contas de teste não são obrigatórias, mas permitem que você faça chamadas de API e teste seu código antes que o token de desenvolvedor seja aprovado. Siga estas instruções para criar contas e campanhas de teste.
Escolher uma biblioteca de cliente
Faça o download de uma das bibliotecas de cliente da API Google Ads.
Cada biblioteca de cliente inclui amostras de código e instruções de instalação.
Configurar o OAuth2
O OAuth2 permite que seu aplicativo funcione em nome da sua conta. Esse fluxo de trabalho é destinado a aplicativos para computador. Consulte Configurar um projeto do Console de APIs do Google para mais informações.
Para usar o OAuth2 com as APIs do Google, crie um ID e uma chave secreta do cliente para o OAuth2:
- Depois de fazer login na sua conta de administrador, abra a página "Credenciais" do Console de APIs do Google.
- Expanda o menu suspenso Projetos e escolha NOVO PROJETO.
- Digite um nome para o projeto e clique em CRIAR.
- Na barra lateral, clique em Tela de consentimento OAuth, insira as informações necessárias e clique em SALVAR E CONTINUAR. Consulte o guia do OAuth para mais detalhes.
- Na barra lateral, clique em Configurações > CRIAR CREDENCIAIS > ID do cliente OAuth e escolha App para computador.
- Insira um nome para o cliente e clique em CRIAR.
Isso gera o ID e a chave secreta do cliente.
Receber um token de atualização
Você também precisa de um token de atualização para acessar as APIs do Google.
Para receber um token de atualização, siga as etapas da biblioteca de cliente escolhida. As etapas são diferentes para cada linguagem de programação. Veja os exemplos de autenticação de cada biblioteca.
Fazer sua primeira chamada de API
Siga o tutorial de primeira chamada da API Google Ads para fazer uma chamada simples.
Etapas automáticas
Indisponível para este processo.