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 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 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 com um único endereço IP (ou seja, em nome dos seus usuários), use o parâmetro userIP ou quotaUser em 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.

APIs de geração de relatórios

As cotas a seguir se aplicam a todas as APIs Reporting, incluindo a API Core Reporting v3, a API Analytics Reporting v4, a API Real Time v3 e a API Multi-channel Funnel v3:

  • 10.000 solicitações por vista (perfil) e por dia
  • 10 solicitações simultâneas por vista (perfil)

Erros de solicitação das APIs de relatórios

Se a solicitação para a API Reporting falhar com um erro de servidor, você receberá um código de resposta 500 ou 503. Você pode reenviar a solicitação, no entanto, não envie novamente mais de uma vez se ela falhar repetidamente. O Google Analytics permite:

  • 10 solicitações com falha de erro do servidor por projeto, vista (perfil) e hora
  • 50 solicitações com falha de erro de servidor por projeto, vista (perfil) e dia

Se o número de solicitações com falha exceder essas cotas, você verá o seguinte erro:

Quota Error: The number of recent reporting API requests failing by server error is too high.
You are temporarily blocked from the reporting API for at least an hour.
Please send fewer server errors in the future to avoid being blocked.

Para diminuir a chance de erros no servidor de solicitações, simplifique a solicitação: reduza o período e o número de dimensões na solicitação ou o número de métricas na solicitação.

Não reenvie continuamente uma solicitação com falha. Em vez disso, implemente a espera exponencial para reenviá-la.

As cotas de taxa de erro do servidor são aplicadas em períodos contínuos para cada uma das cotas de taxa de erro por hora e diárias. Uma hora após um projeto e visualizar o primeiro erro de servidor do par, a cota é redefinida. Se um par de projeto e visualização enviar 10 erros de servidor em uma hora, esse par será bloqueado na API até uma hora após o primeiro erro de servidor.

Por exemplo, se um par de projeto e visualização não tiver enviado um erro de servidor nas últimas 24 horas, o projeto e a visualização vão ter usado 0 da cota de 50. Digamos que o projeto e a visualização agora enviem um erro de servidor às 6h12. Se ele e a visualização enviarem 49 erros de servidor adicionais antes das 6h12 do dia seguinte, esse projeto e a visualização vão ser bloqueados até as 6h12 do dia seguinte. Às 6h12 do dia seguinte, a cota de taxa de erro do servidor será completamente redefinida para esse projeto e visualização.

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 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. Para a 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 na 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.