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 contas de produção e o número de operações e solicitações que pode executar diariamente. O uso permitido determina os recursos específicos da API Google Ads que o token do 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 tem acesso à API Google Ads, faça sua inscrição para ter acesso à conta de teste. É possível aumentar o nível de acesso seguindo algumas etapas adicionais no aplicativo.
| Nível de acesso | Pode acessar... | Limite de operações diárias1 | Aplicar |
|---|---|---|---|
| Acesso à conta de teste | Contas de teste | 15.000 operações / dia | Instruções |
| Acesso básico | Contas de teste e de produção | 15.000 operações por dia | Instruções |
| Acesso padrão | Contas de teste e de produção | Operações ilimitadas / dia | Instruções |
1 "Por dia" é baseado em um período deslizante 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.
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 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
Conclua a inscrição na API Google Ads na interface da Web do Google Ads para 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. Contas de produção são contas que veiculam anúncios reais 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 acesso básico
Se você tiver um token de desenvolvedor de nível de acesso à conta de teste e quiser solicitar o acesso à conta de produção, preencha o formulário de solicitação de acesso básico. Verifique se você concluiu estas etapas:
- Verifique se você já tem um token de desenvolvedor com o nível de acesso da conta de teste.
- Verifique se o e-mail de contato da API na Central de APIs está atualizado. Você precisa fazer login na sua conta de administrador 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 com o token da 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 ao acesso padrão, consulte
Cotas de API.
O nível de acesso padrão só é concedido a desenvolvedores que precisam de operações ilimitadas da API Google Ads, como grandes empresas ou ferramentas que atendem a muitos usuários.
Independentemente do nível de acesso, todas as operações de API estão sujeitas a limites de taxa do sistema. Para saber mais sobre como lidar com erros de limite de taxa, consulte Tipos de erros.
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 a ferramenta for externa, esteja preparado para fornecer acesso de login de demonstração à sua ferramenta. Observe que ela precisa obedecer aos Recursos mínimos obrigatórios.
Uso permitido
O uso permitido se aplica apenas a 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 elaborado na tabela a seguir:
| Uso permitido | Descrição |
|---|---|
| Criação / gerenciamento de anúncios | Ofereça 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 acesse RecommendationService, KeywordPlanIdeaService e KeywordPlanService. Isso é usado apenas por ferramentas que exigem sugestões para facilitar a criação e o gerenciamento de campanhas do Google Ads. |
Como se inscrever para o uso permitido
Se você tiver sido aprovado para o nível de acesso básico ou padrão, preencha o formulário para atualizar o uso permitido. Preencha o formulário se quiser atualizar o uso permitido ou conceder aos seus clientes acesso à ferramenta.