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.
- Depois de se inscrever, seu token fica com o status aprovação pendente.
- Verifique se o software obedece aos Termos e Condições (T&C) da API Google Ads e aos Recursos mínimos obrigatórios (RMF). O RMF é necessário apenas para tokens com acesso padrão.
É possível 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 antes de ser usado 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 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.
Escolher 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 seu app opere em nome da sua conta. Este fluxo de trabalho é para apps de 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 OAuth2:
- Faça login na sua conta de administrador e abra a página "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 em Tela de consentimento do 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 Credenciais > 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 variam de acordo com cada linguagem de programação. Consulte os exemplos de autenticação de cada biblioteca.
Fazer sua primeira chamada de API
Siga o tutorial da primeira chamada da API Google Ads para fazer uma chamada simples.
Etapas automáticas
Não disponível para este processo.