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 a cada 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. 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 nas solicitações para receber toda a cota de QPS de cada usuário. Consulte o resumo de parâmetros de consulta padrão para ver mais detalhes.

APIs de relatórios

As cotas a seguir se aplicam a todas as APIs de relatórios, incluindo API Core Reporting v3, API Analytics Reporting v4, API Real Time v3 e 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 houver uma falha na sua solicitação da API de relatórios, e o código de resposta 500 ou 503 for exibido, você poderá reenviá-la. O Google Analytics permite:

  • 10 solicitações com falha por projeto, por perfil e por hora;
  • 50 solicitações com falha por projeto, por perfil e por dia.

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

Quota Error: The number of recent failed writes is too high.

Em vez de continuar tentando reenviar uma solicitação com falha, implemente a retirada exponencial para reenviá-la.

API Reporting v4 do Google Analytics

Estas cotas se aplicam somente à API Reporting v4 do Google Analytics:

  • Grupo de cotas:
    • Número de solicitações por dia e por projeto: 50.000
    • Número de solicitações por vista (perfil) e por dia: 10 000 (sem possibilidade de aumento)
    • Número de solicitações por 100 segundos e por projeto: 2.000
    • Número de solicitações por 100 segundos, por usuário e por projeto: 100 (com possibilidade de aumento para 1.000 no Console de APIs do Google).
  • Solicitações de descoberta:
    • Número de solicitações por 100 segundos: 17.000

Você pode ver as cotas do seu projeto no Console de APIs do Google.

Cota com base em recursos

A API Reporting v4 do Google Analytics também é regida pela cota com base em recursos opcional, que permite o uso de limites de amostragem mais altos para clientes do Google Analytics 360.

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 limites de uso do projeto ou para solicitar um aumento da cota, faça o seguinte:

  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 Google 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 Reporting v4, o nome da API no Console de APIs do Google é API Google Analytics Reporting. Todas as outras APIs v3 (por exemplo, API Management v3, API Core Reporting v3, API Real Time Reporting v3, 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.