Limites e cotas para solicitações de APIs

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 ou quotaUser 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 User Deletion

Esta cota se aplica a solicitações de exclusão de usuários:

  • 1,5 consulta por segundo (QPS) por propriedade ou projeto do Firebase;
  • 500 consultas por dia (QPD) por projeto de nuvem.

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:

Para conferir ou mudar os limites de uso do projeto ou solicitar um aumento da cota, siga estas etapas:

  1. Se você ainda não tem uma conta de faturamento para o projeto, crie uma.
  2. Acesse a página "APIs ativadas" da biblioteca de APIs no Console de APIs e selecione uma API da lista.
  3. 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.