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.

APIs de gerenciamento

O Google Analytics aplica cotas para as solicitações a estas APIs de gerenciamento:

APIs de gravação

Estas cotas se aplicam às solicitações de gravação (insert, update, patch e delete):

  • 50 solicitações de gravação por projeto e por dia. É possível aumentar esse número
  • 1,5 consulta por segundo (QPS) por ID da conta

Erros na solicitação de criação

Se sua solicitação de gravação apresenta falha e você recebe um código de resposta 500 ou 503, é possível reenviá-la. O Google Analytics permite:

  • 50 solicitações de gravação com falha por hora.

Se você tentar enviar mais de 50 solicitações de gravação com falha por hora, receberá a seguinte mensagem de erro:

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

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

API de importação de dados

Estas cotas são específicas para o recurso Uploads:

  • Limites de armazenamento de importação de dados estendidos em todo o ciclo de vida (não se aplica a dados de hits enviados de APIs e SDKs de coleta):
  • 50 conjuntos de dados por propriedade
  • 50 operações de upload por propriedade e por dia
  • 1 GB por arquivo enviado
  • Limites específicos dos dados de custo:
    • 100 MB por data (ga:date) por conjunto de dados. Por exemplo, se você fizer um primeiro upload de 50 MB de informações em 10/10/2014 e um segundo upload de 50 MB de dados nessa mesma data, atingirá o limite de 100 MB em 10/10/2014 nesse conjunto.

API Experiments

Esta cota se aplica somente aos experimentos:

  • 12 experimentos por vista (perfil)

Os experimentos com uma das statuses a seguir são contabilizados nessa cota:

  • DRAFT
  • READY_TO_RUN
  • RUNNING

Os experimentos finalizados (status = ENDED) há mais de um dia não são contabilizados nessa cota.

API de relatórios sem dados de amostra

Estas cotas se aplicam somente aos relatórios sem dados de amostra:

  • As solicitações de API para criar relatórios sem dados de amostra são contabilizadas na cota geral de solicitações de gravação.
  • A API usa o mesmo sistema de token por propriedade e por dia que a interface da Web utiliza para criar os relatórios sem dados de amostra.
  • São permitidos no máximo 3.500 relatórios sem dados de amostra. Quando esse limite é atingido, a tentativa de criar mais relatórios sem dados de amostra com a API resulta no seguinte erro:
    Error creating this entity. You have reached the maximum allowed entities of this type.

API User Permission

Esta cota se aplica somente às permissões de usuários:

  • Um usuário pode ter no máximo 100 contas do Google Analytics. Se você adicionar um usuário com 100 contas do Google Analytics a uma nova conta, um erro será exibido.

As cotas a seguir se aplicam a solicitações de gravação em lote (delete, insert, update) para permissões de usuário:

  • 300 solicitações de gravação de permissão de usuários por solicitação em lote.
  • 30 solicitações de gravação de permissão de usuários em lote são contabilizadas como 1 solicitação de gravaçã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. 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.