Níveis de acesso e uso permitido

Cada token de desenvolvedor da Google Ads API recebe um nível de acesso e "uso permitido". O nível de acesso determina se você pode afetar contas de produção e o número de operações e solicitações que podem ser executadas diariamente. O uso permitido determina os recursos específicos da Google Ads API que o token de desenvolvedor pode usar.

Níveis de acesso

Há três níveis de acesso diferentes listados em ordem na tabela. Se você ainda não tem acesso à API Google Ads, inscreva-se para receber acesso a uma conta de teste. É possível aumentar o nível de acesso seguindo algumas etapas adicionais no aplicativo.

Nível de acesso Pode acessar... Limite de operações diárias1 Aplicar
Testar o acesso à conta Contas de teste 15.000 operações por dia Instruções
Acesso básico Contas de teste e de produção 15.000 operações por dia Instruções
Acesso padrão Contas de teste e de produção Operações ilimitadas / dia Instruções

1 "Por dia" se baseia em um período de 24 horas em que as solicitações de API foram feitas com seu token de desenvolvedor. Se o aplicativo exceder o limite de solicitações do seu nível de acesso nas últimas 24 horas, ele vai receber um erro.

Testar o acesso à conta

Depois de concluir a inscrição inicial na API Google Ads, você recebe um token de desenvolvedor com o nível de acesso "Conta de teste". Isso significa que o token de desenvolvedor só pode fazer solicitações da Google Ads API nas contas de teste.

Como solicitar o acesso à conta de teste

Conclua a inscrição na API Google Ads na interface da Web do Google Ads para receber automaticamente o nível de acesso da conta de teste.

Acesso básico

Com o nível de acesso básico, o token de desenvolvedor pode fazer solicitações da API Google Ads em contas de teste e de produção. As contas de produção são aquelas que veiculam anúncios reais e ativos do Google. As contas de teste não veiculam anúncios.

O nível de acesso básico permite que o token de desenvolvedor execute até 15.000 operações por dia. Isso é suficiente para a maioria dos desenvolvedores.

Como se inscrever no acesso básico

Se você tiver um token de desenvolvedor com nível de acesso à conta de teste e quiser solicitar acesso à conta de produção, preencha o formulário de solicitação de acesso básico. Confirme que você concluiu estas etapas:

  1. Verifique se você já tem um token de desenvolvedor com nível de acesso à conta de teste.
  2. Verifique se o e-mail de contato da API na Central de API está atualizado. Você precisa fazer login na sua conta de administrador para acessar a Central de API. Não é possível concluir o processo de inscrição sem um endereço de e-mail válido e verificado regularmente. Verifique se você vinculou todas as suas contas ativas do Google Ads à conta de administrador com o token da API.

Acesso padrão

O nível de acesso padrão permite que o token de desenvolvedor execute um número ilimitado de operações por dia na maioria dos serviços. Isso inclui, mas não se limita a GoogleAdsService Search e SearchStream. Para mais detalhes sobre limites e exceções ao nível de acesso padrão, consulte Cotas de API.

O nível de acesso padrão é concedido apenas a desenvolvedores que precisam de operações ilimitadas da API Google Ads, como grandes empresas ou ferramentas que atendem a muitos usuários.

Independente do nível de acesso, todas as operações da API estão sujeitas a limites de taxa do sistema. Para saber mais sobre como lidar com erros de limite de taxa, consulte Tipos de erros.

Como solicitar o acesso padrão

Se você tiver um token de desenvolvedor com nível de acesso básico e quiser solicitar operações ilimitadas da API Google Ads, preencha o formulário de solicitação de acesso padrão.

Se a ferramenta for externa, prepare-se para fornecer acesso de demonstração a ela. Observe que ela precisa obedecer aos Recursos mínimos obrigatórios.

Uso permitido

O uso permitido se aplica apenas a tokens de desenvolvedor com níveis de acesso básico e padrão. O uso permitido é alocado com base no uso pretendido da API Google Ads. Essas permissões determinam para quais recursos da API um token de desenvolvedor pode ser usado, conforme detalhado na tabela a seguir:

Uso permitido Descrição
Criação / gerenciamento de anúncios Fornece acesso a todos os serviços da API para criar e gerenciar campanhas, grupos de anúncios, anúncios e palavras-chave do Google Ads.
Relatórios Faça apenas solicitações GoogleAdsService.Search ou GoogleAdsService.SearchStream ou chamadas somente leitura. Isso é para desenvolvedores que usam a API apenas para solicitar estatísticas.
Pesquisar palavras-chave e recomendações Permita que o token acesse "RecommendationService", "KeywordPlanIdeaService" e "KeywordPlanService". Usado apenas por ferramentas que precisam de sugestões para facilitar a criação e o gerenciamento de campanhas do Google Ads.

Como mudar o uso permitido

Se o token de desenvolvedor foi aprovado para o nível de acesso básico ou padrão, preencha a solicitação para atualizar o uso permitido. Preencha o formulário se quiser atualizar o uso permitido ou conceder aos clientes acesso à sua ferramenta.