Resumo
Solicite um token de desenvolvedor e receba 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, o token fica com a aprovação pendente.
- Verifique se o software está em conformidade com os Termos e Condições (T&C) e com os Recursos mínimos obrigatórios (RMF, na sigla em inglês) da API Google Ads. Os RMF só são necessá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:
- Testar
- Básico
- Standard
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 fazer chamadas de API e testar seu código antes da aprovação do token de desenvolvedor. Siga estas instruções para criar contas e campanhas de teste.
Escolha uma biblioteca de cliente
Faça o download de uma das bibliotecas de cliente da API Google Ads.
Exemplos de código e instruções de instalação estão incluídos em cada biblioteca de cliente.
Configurar o OAuth2
O OAuth2 permite que o app opere em nome da sua conta. Esse fluxo de trabalho é destinado a apps 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 do OAuth2:
- Depois de fazer login na sua conta de administrador, abra a página de credenciais do Console de APIs do Google.
- Expanda o menu suspenso Projetos e escolha NOVO PROJETO.
- Insira um nome para o projeto e clique em CRIAR.
- Na barra lateral, clique na Tela de permissão 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 Credenials > 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.