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 as 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 API Google Ads 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 tiver acesso à Google Ads API, inscreva-se para receber acesso à conta de teste. É possível aumentar o nível de acesso seguindo outras instruções do aplicativo.

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

1 "Por dia" é baseado em um período de 24 horas deslizante em que as solicitações de API foram feitas com seu token de desenvolvedor. O aplicativo receberá um erro se exceder o limite de solicitação do nível de acesso nas últimas 24 horas.

2 get será desativado na v10. Use search ou searchStream para recuperar objetos.

Acesso à conta de teste

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

Como se inscrever para uma conta de teste

Depois de concluir a inscrição na API Google Ads na IU, você receberá automaticamente o nível de acesso da conta de teste.

Acesso básico

O acesso básico permite que o token de desenvolvedor faça solicitações da Google Ads API nas contas de teste e de produção. As contas de produção são aquelas que veiculam anúncios do Google reais e ativos (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 solicitações por dia e 1.000 operações get por dia. Isso é suficiente para a maioria dos desenvolvedores.

Como se inscrever para o acesso básico

Se você tem um token de desenvolvedor com nível de acesso de conta de teste e quer solicitar acesso à conta de produção, preencha o formulário de inscrição de acesso básico. Siga estas etapas simples:

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

Acesso padrão

O acesso padrão permite que o token de desenvolvedor execute um número ilimitado de operações por dia para a maioria dos serviços. Isso inclui, entre outros: GoogleAdsService Search e SearchStream. Para mais detalhes sobre limites e exceções, consulte a página Cotas da API.

Os tokens de acesso padrão ainda estão sujeitos ao limite diário de 1.000 operações get. O nível de acesso padrão será concedido apenas a desenvolvedores que precisarem de operações ilimitadas da API Google Ads (normalmente, grandes empresas ou ferramentas que atendem a muitos usuários).

Como se inscrever para o acesso padrão

Se você tem um nível de acesso básico e quer se inscrever para operações ilimitadas da Google Ads API, preencha o formulário de inscrição de acesso padrão.

Se sua ferramenta for externa, prepare-se para conceder acesso de login a ela. Observe que ela precisa obedecer aos Recursos mínimos obrigatórios.

Uso permitido

O uso permitido aplica-se somente aos tokens 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 pode ser usado, conforme descrito na tabela abaixo.

Veja a seguir uma lista dos usos permitidos:

Uso permitido Descrição
Criação / gerenciamento de anúncios Fornecer acesso a todos os serviços da API para criação e gerenciamento de 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 é destinado a desenvolvedores que usam a API somente para solicitar estatísticas.
Pesquisa de palavras-chave e recomendações Permitir que o token acesse RecommendationService, KeywordPlanIdeaService e KeywordPlanService. Essa ferramenta só é usada por ferramentas que requerem sugestões para ajudar a facilitar a criação e o gerenciamento de campanhas do Google Ads.

Como se inscrever para o uso permitido

Se você foi aprovado para o nível de acesso básico ou padrão, preencha nossa inscrição de atualização do uso permitido. Preencha o aplicativo se quiser atualizar o uso permitido ou conceder acesso aos clientes para a ferramenta.