Níveis de acesso e uso permitido

Cada token de desenvolvedor da API Google Ads recebe um nível de acesso e um "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 API Google Ads que o token de desenvolvedor pode usar.

Níveis de acesso

Há quatro níveis diferentes de acesso ao token de desenvolvedor listados em ordem na tabela. Se você ainda não tiver acesso à API Google Ads, comece se inscrevendo para receber um token de desenvolvedor com o nível de acesso "Conta de teste". Para aumentar o nível de acesso, siga algumas etapas adicionais no aplicativo.

Nível de acesso	Pode acessar...	Limite de operações diárias^1	Como se inscrever	Quanto tempo leva uma análise?
Nível de acesso da conta de teste	Contas de teste	15.000 operações por dia	Instruções
Nível de acesso às Análises	Contas de teste e de produção	2.880 operações por dia para contas de produção 15.000 operações por dia para contas de teste	Instruções
Nível de acesso básico	Contas de teste e de produção	15.000 operações por dia para contas de teste e produção	Instruções	2 dias úteis
Nível de acesso padrão	Contas de teste e de produção	Operações ilimitadas por dia para contas de teste e de produção	Instruções	10 dias úteis

¹ "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.

Nível de acesso da conta de teste

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.

Importante: consulte o guia da conta de teste para saber como criar uma conta de teste.

Como solicitar o nível de 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 à conta de teste.

Nível de acesso às Análises

Depois que você concluir a inscrição inicial na API Google Ads, o Google poderá atualizar automaticamente seu token de desenvolvedor do nível Acesso à conta de teste para o nível de acesso do Explorer em alguns casos. O nível de acesso "Explorer" permite que o token de desenvolvedor faça 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 "Explorador" permite que o token de desenvolvedor execute até 2.880 operações por dia em contas de produção. Isso é suficiente para a maioria dos desenvolvedores começarem a usar a API e criar automações básicas.

O nível de acesso do Explorer restringe o acesso aos seguintes recursos: Se você precisar usar esses recursos, solicite o nível de acesso básico ou o nível de acesso padrão.

Funcionalidade restrita	Serviços e métodos restritos
Criação de conta	CustomerService.CreateCustomerClient
Gerenciamento de usuários	CustomerUserAccessInvitationService CustomerUserAccessService
Planejamento	KeywordPlanService KeywordPlanIdeaService KeywordPlanCampaignService KeywordPlanCampaignKeywordService KeywordPlanAdGroupService KeywordPlanAdGroupKeywordService AudienceInsightsService KeywordPlanIdeaService ReachPlanService
Faturamento e pagamento da conta	PaymentsAccountService BillingSetupService AccountBudgetProposalService InvoiceService

Como solicitar o nível de acesso de explorador

Conclua a inscrição na API Google Ads na interface da Web do Google Ads. Em alguns casos, o Google pode fazer upgrade automático do seu token de desenvolvedor para o nível de acesso do Explorer depois que você concluir a inscrição.

Nível de 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 solicitar o nível de 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 nível 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 no centro de APIs está atualizado. Você precisa fazer login na sua conta de administrador do Google Ads 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 do Google Ads com o token da API.

Nível de 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.

Como solicitar o nível de 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 nível 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.

Cotas de API e limites de taxa do sistema

Independente do nível de acesso, todas as operações da API estão sujeitas a limites de taxa do sistema, que restringem quantas operações podem ser realizadas em um período, ou seja, o número de operações por hora. Para saber mais sobre como lidar com erros de limite de taxa, consulte tipos de erros.

Serviços individuais podem impor outros limites e restrições de cota por motivos como limitações de design e política do produto, além de considerações sobre desempenho e latência da API. Consulte a documentação sobre cotas de API para saber mais sobre essas restrições.

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 de desenvolvedor acesse RecommendationService, KeywordPlanIdeaService, e KeywordPlanService. Isso só é usado 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 seu uso permitido ou conceder aos clientes acesso à sua ferramenta.