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 diárias por projeto. É 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 por 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 usuários), use o parâmetro userIP ou quotaUser para cada solicitação. Assim, você receberá a cota total de QPS de cada usuário. Consulte o resumo dos parâmetros de consulta padrão para mais detalhes.

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. Veja os Termos de Serviço para mais informações.

Solicitação de cota adicional

Você só pode fazer uma solicitação para aumentar:

Para conferir ou mudar limites de uso do projeto ou pedir um aumento da cota, faça o seguinte:

  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 conferir e mudar configurações relacionadas a cotas, selecione Cotas. Para conferir 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 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.