Com um token de desenvolvedor do Google, seu aplicativo pode se conectar à API Google Ads. Cada token de desenvolvedor recebe um nível de acesso que controla o número de chamadas de API que podem ser feitas por dia com o token, bem como o ambiente em que é possível fazer chamadas. Saiba mais.
Cada projeto do Console de APIs do Google pode ser associado ao token de desenvolvedor de apenas uma conta de administrador. Depois que você fizer uma solicitação da Google Ads API, o token de desenvolvedor será pareado permanentemente ao projeto do Console de APIs do Google.
Ao alternar para um token de desenvolvedor em uma nova conta de administrador, primeiro você precisa criar um novo projeto do Console de APIs do Google para solicitações da API Google Ads que usam o token do novo administrador. Se você não usar um novo projeto do Console de APIs do Google,
receberá um erro DEVELOPER_TOKEN_PROHIBITED ao fazer uma solicitação.
Procedimento
Etapa 1: selecionar ou criar uma conta de administrador do Google Ads
Primeiro, você precisa ter uma conta de administrador do Google Ads antes de solicitar um token de desenvolvedor.
As contas de administrador não podem ser criadas usando o mesmo endereço de e-mail de uma conta do Google Ads existente. Portanto, use um endereço de e-mail que não tenha sido associado a uma conta do Google Ads.
A conta de administrador selecionada não afeta o conjunto de contas do Google Ads que o token de desenvolvedor pode acessar. Ele é usado apenas para armazenar o token de desenvolvedor.
O token pode acessar qualquer conta, desde que você tenha as credenciais de OAuth adequadas. No entanto, vincular essa conta de administrador às contas ativas do Google Ads da sua empresa simplificará o processo de análise do aplicativo e reduzirá o número de vezes que você precisa passar pelo processo de autenticação para gerenciar suas contas com a API. Para mais detalhes, consulte o artigo da Central de Ajuda sobre como vincular contas.
Etapa 2: inscrever-se para acessar a Google Ads API
Inscreva-se para acessar a API Google Ads usando sua conta de administrador. Faça login e navegue até FERRAMENTAS E CONFIGURAÇÕES > CONFIGURAÇÃO > Central de API. A opção Central de API é exibida apenas para contas de administrador do Google Ads.
Todos os campos do formulário de acesso à API precisam ser preenchidos, e os Termos e Condições precisam ser aceitos. Verifique se as informações estão corretas e se o URL do site da empresa está funcionando. Se o site não for uma página ativa, não poderemos processar a inscrição.
Verifique se o e-mail de contato da API fornecido leva a uma caixa de entrada monitorada regularmente. Se não pudermos entrar em contato com você neste endereço de e-mail, não poderemos processar sua inscrição, e ela será rejeitada.
Você pode editar o e-mail de contato da API na Central de API.
Recomendamos que você mantenha essas informações atualizadas, mesmo após o processo de inscrição, para podermos enviar avisos de serviço importantes.
Etapa 3: continuar sua inscrição
Seu token de desenvolvedor pendente precisa ser aprovado para poder ser usado com as contas de produção do Google Ads. É possível aplicar o acesso básico ou o acesso padrão.
Solicite o acesso básico se o uso da API for mínimo.
Inscreva-se para o acesso padrão se você espera que o uso da API seja alto.
Consulte a planilha de tarifas para determinar se você precisa do acesso básico ou padrão. Se você não tiver certeza sobre o uso futuro da API, recomendamos começar com o acesso básico e fazer upgrade para o acesso padrão quando o uso da API do seu app se aproximar das limitações de cota aplicadas pelo acesso básico com frequência.
Os aplicativos de acesso básico e padrão são analisados para garantir que a ferramenta ou o app de software que você propõe usar com a API Google Ads esteja em conformidade com nossos Termos e Condições e políticas, incluindo a funcionalidade mínima obrigatória (RMF, na sigla em inglês), se aplicável. Se sua empresa gerencia contas do Google Ads para clientes, você precisa estar em conformidade com nossa política de terceiros para ter acesso à API Google Ads.
Geralmente entramos em contato em até dois dias úteis a partir da data de envio da inscrição no endereço de e-mail fornecido na Etapa 2. Se você não tem mais acesso a essa caixa de entrada ou não planeja monitorar ativamente esse endereço de e-mail, edite seu endereço na Central de API seguindo as instruções acima na Etapa 2 para que possamos entrar em contato.
A equipe de revisão aprovou meu token de desenvolvedor
O token de desenvolvedor atribuído será ativado para o ambiente de produção quando sua solicitação de acesso à API for aprovada. Esse token estará disponível na Central de API, que pode ser acessado pelo menu Configurações da conta referente à conta de administrador que você usou para se inscrever. É possível acessar a API incluindo-a nos cabeçalhos das solicitações ao interagir com nosso sistema.
É muito importante que você mantenha seu e-mail de contato atualizado, já que enviamos informações importantes sobre alterações ou interrupções de serviço para o endereço de e-mail especificado.
Se você fizer mudanças na sua ferramenta no futuro, precisará informar o Google ao Formulário de alteração da ferramenta da API Google Ads.
A equipe de revisão rejeitou meu token de desenvolvedor
A equipe de revisão de tokens examina as informações fornecidas quando você solicita acesso à API Google Ads para garantir que seu software esteja em conformidade com os Termos e Condições (T&C) e com os RMF, se aplicável.
Razões comuns para rejeição de um aplicativo incluem:
- impossibilidade de entrar em contato com você pelo endereço de e-mail fornecido
- Você fez a inscrição porque uma ferramenta de terceiros exige um token de desenvolvedor.
- seu aplicativo viola outras disposições dos Termos e Condições
- O aplicativo não implementa elementos obrigatórios dos recursos mínimos obrigatórios (se aplicável).
Se você alterou sua ferramenta de API para que ela fique em conformidade com a política da Google Ads API ou se acredita que sua inscrição foi rejeitada incorretamente, faça a inscrição novamente clicando no link Inscrever-se novamente na página da Central de API da sua conta de administrador.
Se você não receber um e-mail nosso sobre sua inscrição dentro do prazo previsto, entre em contato com a Equipe de conformidade da API Google Ads.
Faturamento
Não há cobranças pelo uso da Google Ads API. Cobramos taxas de não conformidade por não obedecer à funcionalidade mínima necessária. Consulte a tabela de preços para mais detalhes.