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 Google Analytics API.

Limites gerais de cota

As cotas a seguir se aplicam às APIs de gerenciamento, relatórios principais v3, relatórios de funis multicanal, metadados e relatórios em tempo real:

  • 50.000 solicitações por projeto e 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 descrita como 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. Mas o número de solicitações à API é restringido a no máximo 10 solicitações por segundo e por usuário.
    • Se seu 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 nas solicitações para receber a cota de QPS para cada usuário. Consulte o resumo de parâmetros de consulta padrão para ver 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. Consulte os Termos de Serviço para mais informações.

Solicitação de cota adicional

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

Para visualizar ou alterar os limites de uso do seu projeto ou para solicitar um aumento da sua cota, siga estas etapas:

  1. Se você ainda não tem uma conta de faturamento para seu 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 visualizar e alterar 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 Analytics API. Revise as informações e siga as instruções do formulário de solicitação de cota antes de enviar a solicitação. Para a API de relatórios v4, o nome da API no Console de APIs do Google é API de relatórios do Google Analytics. Todas as outras APIs v3 (por exemplo, API de gerenciamento v3, API de relatórios principais v3, API de relatórios em tempo real v3) estão listadas em Analytics API 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.