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. Para aumentar o nível de acesso, conclua 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 | Solicitar acesso básico | |
| Padrão | Contas de teste e de produção | Operações ilimitadas por dia para contas de teste e 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. Seu aplicativo vai receber um erro se exceder o limite de solicitações para seu nível de acesso nas últimas 24 horas.
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".
O nível de acesso de exploração 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 "Explorador" permite que seu projeto na nuvem 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 "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 pedir o 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
Com o nível de acesso básico, 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 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.
Inscrever-se para 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 Básico assim 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 e restrições de taxa 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 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.
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. Prepare-se 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 por login de demonstração à ferramenta. 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 rapidamente à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 de 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.
Os 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 na nuvem do Google Cloud tiver sido 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.