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 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. 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.

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):

  • 500 solicitações de gravação por projeto e a cada 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 durante todo o período (não se aplica a dados de hits enviados a partir 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 para 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 dados 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 de dados.

API de experimentos

Esta cota se aplica somente aos experimentos:

  • 12 experimentos por vista (perfil)

Os experimentos que têm um dos 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 e você tenta usar a API para criar mais relatórios sem dados de amostra, o seguinte erro é exibido:
    Error creating this entity. You have reached the maximum allowed entities of this type.

API de permissão de usuários

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, causará um erro.

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

  • 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. 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 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. Se você quiser ver as estatísticas de utilização, 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 antes de enviar a solicitação. No caso da API de relatórios v4, o nome da API no Console 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 Google Analytics API no Console.

Para mais detalhes sobre como gerenciar cotas e ajustar seu aplicativo para usá-las, consulte Monitoramento de APIs e limite de uso.