Este documento descreve os limites e as cotas das solicitações das APIs de gerenciamento e relatórios.
Milhões de sites usam o Google Analytics. Para que o sistema não receba mais dados do que consegue gerenciar e para garantir uma distribuição equitativa dos recursos dele, estabelecemos limites e cotas para as solicitações de APIs. Esses limites e cotas estão sujeitos a alterações.
Este vídeo discute as práticas recomendadas para o gerenciamento das cotas de solicitação da API Google Analytics.
Limites gerais de cota
As cotas a seguir se aplicam à API Management, API Core Reporting v3, API MCF Reporting, API Metadata, API User Deletion e API Real Time Reporting:
- 50.000 solicitações por projeto por dia. É possível aumentar esse número.
- 10 consultas por segundo (QPS, na sigla em inglês) por endereço IP
- No Console de APIs, há uma cota semelhante chamada de Solicitações a cada 100 segundos por usuário. Por padrão, ela é definida como 100 solicitações a cada 100 segundos por usuário e pode ser ajustada para no máximo 1.000. Porém, o número de solicitações à API fica limitado a até 10 solicitações por segundo e por usuário.
- Se o aplicativo fizer todas as solicitações de API de um único endereço IP (ou seja, em nome dos seus usuários), use o parâmetro
userIP
ouquotaUser
com cada solicitação para receber a cota completa de QPS de cada usuário. Consulte o resumo de parâmetros de consulta padrão para ver mais detalhes.
API Provisioning
Essa cota se aplica às solicitações de gravação (por exemplo, createAccountTicket
) para a API Provisioning:
- 50 solicitações por projeto e por dia.
- 1,5 consulta por segundo (QPS) por ID da conta.
Limites de cota excedentes
Se a cota de solicitação de uma API do Google Analytics for excedida, a API retornará um código de erro 403
ou 429
e uma mensagem informando que a conta excedeu a cota. Para mais informações, consulte os Termos de Serviço.
Solicitação de cota adicional
Você só pode fazer uma solicitação para aumentar:
- o número de solicitações diárias de leitura por projeto (50.000 como padrão);
- o número de solicitações diárias de gravação por projeto (50 como padrão).
Para conferir ou mudar os limites de uso do projeto ou solicitar um aumento da cota, siga estas etapas:
- Se você ainda não tem uma conta de faturamento para o projeto, crie uma.
- Acesse a página "APIs ativadas" da biblioteca de APIs no Console de APIs e selecione uma API da lista.
- Para ver e mudar configurações relacionadas a cotas, selecione Cotas. Para ver as estatísticas de uso, selecione Uso.
Para solicitar um aumento do limite máximo, use o formulário de solicitação de cota da API Google Analytics. Revise as informações e siga as instruções no formulário de solicitação de cota antes de enviar a solicitação. Na API Reporting v4, o nome da API no Console de APIs do Google é API Reporting do Google Analytics. Todas as outras APIs v3 (por exemplo, a API Management v3, a API Core Reporting v3, a API Real Time Reporting v3 e a API User Deletion v3) estão listadas em API Analytics no Console de APIs do Google.
Para mais detalhes sobre como gerenciar cotas e ajustar seu aplicativo para usá-las, consulte Monitoramento de APIs e limite de uso.