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 diferentes de acesso à API 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 à conta de teste do seu projeto do Google Cloud. 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ária 1 | 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 | Inscreva-se para o acesso à conta de teste | |
| 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 |
Inscreva-se para o acesso de Explorador | |
| 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 | Inscreva-se para o acesso básico | |
| 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 | Inscreva-se para o acesso padrão | 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 projeto do Google Cloud. 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 ativar a API Google Ads, seu projeto na nuvem do Google Cloud recebe o nível de acesso à conta de teste. Isso significa que o projeto só pode fazer solicitações da API Google Ads em contas de teste.
Inscreva-se para o nível de acesso à conta de teste
Ative a API Google Ads no seu projeto na nuvem do Google Cloud para receber automaticamente o nível de acesso à conta de teste.
Nível de acesso de explorador
Depois de concluir a inscrição inicial na API Google Ads, o Google pode permitir que você se inscreva para o nível de acesso Explorer.
O nível de acesso Explorer 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. 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 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ção básica.
O nível de acesso de Explorador 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 | KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceReachPlanService |
| Faturamento e pagamento da conta | PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
Inscreva-se para 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 expandir a seção Fazer upgrade do nível de acesso.
- Confirme se o Próximo nível de acesso é mostrado como Explorer.
- Clique no botão Aplicar para acesso para se inscrever no nível de acesso de Explorador.
O Google pode fazer upgrade automático do nível de acesso à API do seu projeto para o nível de acesso 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. 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.
Inscreva-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 Análises.
- Clique para expandir a seção Fazer upgrade do nível de acesso.
- Confirme se o Próximo nível de acesso é mostrado como Básico.
- Confirme se não há avisos indicando que você não concluiu a verificação de marca do seu projeto. Se houver, siga as instruções para concluir a verificação de marca antes de continuar.
- Clique no botão Inscrever-se para o acesso para se inscrever no nível de acesso básico.
O Google pode fazer upgrade automático do nível de acesso à API do seu projeto para o nível de acesso básico 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 esses recursos, que continuarão sendo aplicados mesmo que seu projeto tenha o nível de acesso padrão.
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.
Inscreva-se para 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 expandir a seção Fazer upgrade do nível de acesso.
- Confirme se o Próximo nível de acesso é mostrado como Padrão.
- Clique no botão Iniciar inscrição para iniciar a inscrição do nível de acesso padrão.
A inscrição de acesso padrão envolve uma auditoria manual detalhada do seu aplicativo. Prepare-se para responder a perguntas sobre a funcionalidade da sua ferramenta e o público-alvo dela. Se a ferramenta for usada por usuários externos, prepare-se para fornecer acesso de login de demonstração a ela. Sua ferramenta precisa obedecer à funcionalidade mínima obrigatória.
Durante todo o processo de análise, a equipe de conformidade do Google vai se comunicar com você usando seu endereço de e-mail. Responda às consultas da equipe de conformidade imediatamente para avançar com a inscriçã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 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.
Serviços individuais podem impor limites e restrições de cota adicionais devido a motivos como limitações de design do produto, restrições de 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 só se aplica a projetos do Google Cloud com níveis 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 | 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 projeto na nuvem do Google Cloud 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. |
Mudar o uso permitido
Se o projeto na nuvem do Google Cloud tiver sido aprovado para o nível de acesso padrão, você pode preencher a inscrição para atualizar o uso permitido. Preencha a inscrição se quiser atualizar o uso permitido ou conceder aos clientes acesso à sua ferramenta.