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 nível de acesso à conta de teste. Para aumentar o nível de acesso, conclua algumas etapas adicionais no aplicativo.
| Nível de acesso | Pode acessar... | Limite de operações diárias1 | 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 do Explorador | 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 | Cinco 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 |
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. Seu aplicativo vai receber um erro se exceder o limite de solicitações do seu nível de acesso nas últimas 24 horas.
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.
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 do Explorador
Depois que você concluir a inscrição inicial na API Google Ads, o Google poderá fazer upgrade automático do 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 "Explorer" 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ção básica.
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 | CustomerUserAccessInvitationServiceCustomerUserAccessService
|
| Planejamento |
KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceKeywordPlanIdeaServiceReachPlanService |
| Faturamento e pagamento da conta |
PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Como solicitar o nível de acesso Explorer
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
O nível de acesso básico 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 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 ou acesso de explorador, poderá solicitar o nível de acesso básico da seguinte maneira:
Acesse https://ads.google.com/aw/apicenter no navegador da Web. Faça login na sua conta de administrador do Google Ads, se necessário.
Verifique se o Nível de acesso é Conta de teste ou Explorer.
Verifique se o e-mail de contato da API no centro de APIs está atualizado. 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.
Clique na seta suspensa ao lado de Nível de acesso e clique no link Solicitar acesso básico.
Concluir a verificação de marca dos projetos do Google Cloud
A API Google Ads usa o status de verificação de marca dos projetos na nuvem do Google Cloud associados a um token de desenvolvedor ao analisar os pedidos de acesso básico. Conclua o processo de verificação de marca no seu projeto na nuvem do Google Cloud para acelerar a análise do seu pedido de acesso básico. Em alguns casos, o Google também pode pedir que você conclua a verificação de marca nos seus projetos na nuvem do Google Cloud como pré-requisito para processar seu pedido de acesso básico. Consulte o guia de verificação de marca para saber mais.
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, poderá solicitar o nível de acesso padrão da seguinte forma:
Acesse https://ads.google.com/aw/apicenter no navegador da Web. Faça login na sua conta de administrador do Google Ads, se necessário.
Verifique se o Nível de acesso é Básico.
Verifique se o e-mail de contato da API no centro de APIs está atualizado. 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.
Clique na seta suspensa ao lado de Nível de acesso e clique no link Solicitar acesso padrão.
Se a ferramenta for usada por usuários externos, prepare-se para fornecer acesso de demonstração à ferramenta. 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 exigem 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 a inscrição se quiser atualizar seu uso permitido ou conceder aos clientes acesso à sua ferramenta.