Seu projeto na nuvem do Google Cloud 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 projeto pode usar.
Níveis de acesso
Há quatro níveis de acesso à API diferentes listados em ordem na tabela. Se você ainda não tiver acesso à API Google Ads, comece ativando a API para receber o nível de acesso de teste no seu projeto na nuvem do Google Cloud. É possível aumentar o nível de acesso concluindo 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? |
|---|---|---|---|---|
| Teste | Contas de teste | 15.000 operações por dia | Solicitar acesso de teste | |
| 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 |
Solicitar acesso ao Explorer | |
| Básico | Contas de teste e de produção | 15.000 operações por dia para contas de teste e de produção | Inscrever-se para o acesso básico | |
| Padrão | Contas de teste e de produção | Operações ilimitadas por dia para contas de teste e de produção | Solicitar acesso padrão | 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 projeto do Google Cloud. Se o aplicativo exceder o limite de solicitações do seu nível de acesso nas últimas 24 horas, ele vai receber um erro.
Testar o acesso
Depois de ativar a API Google Ads, seu projeto na nuvem do Google Cloud recebe acesso de teste. Isso significa que o projeto só pode fazer solicitações da API Google Ads em contas de teste.
Solicitar acesso de teste
Ative a API Google Ads no seu projeto na nuvem do Google Cloud para receber automaticamente o acesso de teste ao projeto.
Nível de acesso de explorador
Depois de concluir a inscrição inicial na API Google Ads, o Google pode permitir que você solicite o nível de acesso "Explorer".
Com o nível de acesso de explorador, seu projeto na nuvem do Google Cloud 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 Explorer permite que seu projeto do Google Cloud 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çõ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 | CustomerUserAccessInvitationServiceCustomerUserAccessService |
| Planejamento | KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceReachPlanService |
| Faturamento e pagamento da conta | PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Solicitar o nível de acesso de explorador
- Acesse a página de visão geral da API Google Ads no seu projeto do Google Cloud.
- Verifique se a página mostra seu nível de acesso atual como Teste.
- Clique para abrir a seção Fazer upgrade do nível de acesso.
- Confirme se o Próximo nível de acesso aparece como Explorer.
- Clique no botão Solicitar acesso para se inscrever no nível de acesso de exploração.
O Google pode fazer upgrade automático do nível de acesso à API do seu projeto para Explorer depois que você enviar a inscrição.
Nível de acesso básico
O nível de acesso básico permite que seu projeto na nuvem do Google Cloud 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 seu projeto na nuvem do Google Cloud execute até 15.000 operações por dia. Isso é suficiente para a maioria dos desenvolvedores.
Solicitar o nível de acesso básico
- Acesse a página de visão geral da API Google Ads no seu projeto do Google Cloud.
- Verifique se a página mostra seu nível de acesso atual como Explorador.
- Clique para abrir a seção Fazer upgrade do nível de acesso.
- Confirme se o Próximo nível de acesso está exibido como Básico.
- Confirme se não há avisos indicando que você não concluiu a verificação de marca do projeto. Se houver, siga as instruções para concluir a verificação da marca antes de continuar.
- Clique no botão Solicitar acesso para pedir o nível de acesso básico.
O Google pode fazer upgrade automático do nível de acesso à API do seu projeto para Basic depois que você enviar a inscrição.
Nível de acesso padrão
O nível de acesso padrão permite que seu projeto na nuvem do Google Cloud execute um número ilimitado de operações por dia para todos os serviços. Serviços e recursos individuais ainda podem ter limites de taxa e restrições específicos para eles, que vão continuar sendo aplicados mesmo que seu projeto tenha um nível de acesso padrão.
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.
Solicitar o nível de acesso padrão
- Acesse a página de visão geral da API Google Ads no seu projeto do Google Cloud.
- Verifique se a página mostra seu nível de acesso atual como Básico.
- Clique para abrir a seção Fazer upgrade do nível de acesso.
- Confirme se o Próximo nível de acesso aparece como Padrão.
- Clique no botão Iniciar inscrição para começar a inscrição no nível de acesso padrão.
A solicitação de acesso padrão envolve uma auditoria manual detalhada do seu aplicativo. Esteja preparado para responder a perguntas sobre a funcionalidade da ferramenta e o público-alvo dela. Se a ferramenta for usada por usuários externos, prepare-se para fornecer acesso de demonstração por login a ela. Sua ferramenta precisa obedecer aos Recursos mínimos obrigatórios.
Durante o processo de análise, a equipe de compliance do Google vai se comunicar com você usando seu endereço de e-mail. Responda às consultas da equipe de compliance para avançar com sua solicitação de acesso padrão. Quando a análise for concluída, o Google vai enviar um e-mail com o resultado final do processo.
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 projetos do Google Cloud com nível de acesso padrão. O uso permitido é alocado com base no uso pretendido da API Google Ads. Essas permissões determinam quais recursos da API sua ferramenta pode usar, 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 projeto do Google Cloud acesse RecommendationService, KeywordPlanIdeaService e KeywordPlanService. Isso é usado apenas por ferramentas que precisam de sugestões para facilitar a criação e o gerenciamento de campanhas do Google Ads. |
Mudar o uso permitido
Se o projeto do Google Cloud foi aprovado para o nível de acesso padrão, preencha a solicitação para atualizar o uso permitido. Preencha o formulário se quiser atualizar o uso permitido ou conceder aos clientes acesso à sua ferramenta.