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 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. Você pode 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 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 de 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" é 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 para o 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ê vai receber 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 do Explorador
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 de Explorador 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 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çar a usar a API e criar automação básica.
O nível de acesso de Explorador restringe o acesso aos seguintes recursos. Se você precisar usar esses recursos, inscreva-se no 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 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
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 no nível de acesso básico da seguinte maneira:
Acesse a Central de APIs no seu 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 Explorer.
Confira se o e-mail de contato da API na Central 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. Confira 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 do nível de acesso e clique no link Inscrever-se no 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 do Google Cloud associados a um token de desenvolvedor ao analisar as inscrições para o nível de acesso básico. Você pode concluir o processo de verificação de marca no seu projeto na nuvem do Google Cloud para acelerar o processo de análise da sua inscrição de acesso básico. Em alguns casos, o Google também pode pedir que você conclua a verificação de marca nos seus projetos do Google Cloud como um pré-requisito para processar sua inscrição 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 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 no nível de acesso padrão da seguinte maneira:
Acesse a Central de APIs no seu 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 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. Confira 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 do nível de acesso e clique no link Inscrever-se no 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 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 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, considerações de desempenho e latência da API. 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 tiver sido aprovado para o nível de acesso básico ou padrão, preencha a inscrição para atualizar o uso permitido. Preencha a inscrição se quiser atualizar o uso permitido ou conceder aos seus clientes acesso à ferramenta.