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 de acesso de token de desenvolvedor diferentes listados em ordem na tabela. Se você ainda não tem acesso à API Google Ads, comece se inscrevendo para receber um token de desenvolvedor com o nível de acesso à conta de teste. É possível aumentar o nível de acesso concluindo algumas etapas adicionais no aplicativo.
| Nível de acesso | Pode acessar... | Limite de operação diária1 | Como se inscrever | Quanto tempo as análises costumam levar? |
|---|---|---|---|---|
| Nível de acesso à 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 de 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 |
1 "Por dia" é baseado 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 nível de acesso nas últimas 24 horas, ele vai receber um erro.
Nível de acesso à 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 API Google Ads nas contas de teste.
Como se inscrever para 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 de concluir a inscrição inicial na API Google Ads, o Google poderá fazer upgrade automático do seu token de desenvolvedor do nível de acesso à conta de teste para o nível de acesso às Análises em alguns casos. O nível de acesso às Análises permite que o token de desenvolvedor faça solicitações da API Google Ads em contas de teste e de produção. 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 às Análises 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çar a usar a API e criar automação básica.
O nível de acesso às Análises restringe o acesso aos seguintes recursos. Se você precisar usar esses recursos, inscreva-se para o nível de acesso básico ou 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 se inscrever para o nível de acesso às Análises
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 às Análises 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. 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 para o nível de acesso básico
Se você tiver um token de desenvolvedor com o nível de acesso à conta de teste ou às Análises, poderá se inscrever para 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 solicitado.
Verifique se o nível de acesso é conta de teste ou Análises.
Confira se o e-mail de contato da API na Central da API está atualizado. Não é possível concluir o processo de inscrição sem um endereço de e-mail válido e verificado regularmente. Confira se você vinculou todas as contas ativas do Google Ads à conta de administrador do Google Ads com o token da API.
Clique na seta suspensa ao lado do nível de acesso e clique no link Inscrever-se para o acesso básico.
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 para a maioria dos serviços. Isso inclui, entre outros,
GoogleAdsService Search e
SearchStream. Para mais detalhes
sobre limites e exceções ao nível de acesso padrão, consulte Cotas da API.
O nível de acesso padrão só é concedido a desenvolvedores que exigem operações ilimitadas da API Google Ads, como grandes empresas ou ferramentas que atendem muitos usuários.
Como se inscrever para o nível de acesso padrão
Se você tiver um token de desenvolvedor com o nível de acesso básico, poderá se inscrever para o nível de acesso padrão 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 solicitado.
Verifique se o nível de acesso é básico.
Confira se o e-mail de contato da API na Central da API está atualizado. Não é possível concluir o processo de inscrição sem um endereço de e-mail válido e verificado regularmente. Confira se você vinculou todas as contas ativas do Google Ads à conta de administrador do Google Ads com o token da API.
Clique na seta suspensa ao lado do nível de acesso e clique no link Inscrever-se para o acesso padrão.
Se a ferramenta for usada por usuários externos, prepare-se para fornecer acesso de login de demonstração a ela. Observe que ela precisa obedecer aos Recursos mínimos obrigatórios.
Cotas da API e limites de taxa do sistema
Independentemente 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 erro.
Os serviços individuais podem aplicar limites e restrições de cota adicionais devido a motivos como limitações de design do produto, restrições da política do produto, desempenho da API e considerações de latência. Consulte a documentação sobre cotas da 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 | Só faz solicitações GoogleAdsService.Search
ou GoogleAdsService.SearchStream
ou chamadas somente leitura. Isso é para desenvolvedores que usam a API apenas para
solicitar estatísticas.
|
| Pesquisa de palavras-chave e recomendações | Permite 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 o formulário para atualizar o uso permitido use. Preencha o formulário se quiser atualizar o uso permitido ou conceder acesso à ferramenta aos seus clientes.