Limites e cotas de APIs

Este documento descreve os limites e as cotas das APIs de gerenciamento e relatórios.

Visão geral

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 solicitações de APIs. Veja a seguir nossas políticas, que estão sujeitas a alterações.

Este vídeo discute as práticas recomendadas para cotas gerais da Google Analytics API que são compartilhadas entre as APIs, bem como cotas específicas das APIs de gerenciamento ou de relatórios.

Limites gerais de cota

Os limites de cota a seguir são compartilhados entre a API de gerenciamento, a API de relatórios principais V3, a API de relatórios de funis multicanal, a API de metadados e a API de 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 IP.
    • No Console de API, há uma cota semelhante conhecida como solicitação a cada 100 segundos por usuário. Por padrão, ela é definida como 100 solicitações a cada 100 segundos e pode ser ajustada para, no máximo, 1.000. Apesar de ser listada como "a cada 100 segundos", a API se restringe a um máximo de 10 solicitações por segundo e por usuário.
    • Se seu aplicativo faz todas as solicitações de API de um único endereço IP (ou seja, em nome dos seus usuários), você deve considerar usar o parâmetro userIP ou quotaUser com cada solicitação. Assim, é possível conseguir a cota QPS completa para cada usuário. Consulte o resumo de parâmetros de consulta padrão para ver detalhes.

API de gerenciamento

Solicitações de criação

Esta cota se aplica a solicitações de criação (por exemplo, insert, update, patch e delete):

Erros na solicitação de criação

Ao implementar o backoff exponencial, você poderá tentar novamente se encontrar as respostas 500 ou 503. Esta cota se aplica a solicitações de criação com falha:

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

Importação de dados

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

  • Limite de armazenamento de importação de dados estendidos durante todo o período (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 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.

Experimentos

Esta cota é específica para experimentos:

  • 12 experimentos por vista (perfil). Experimentos com os seguintes status são contabilizados no limite: DRAFT, READY_TO_RUN e RUNNING. Experimentos com o status ENDED em mais de um dia não são considerados no limite.

Relatórios sem dados de amostra

Estas cotas são específicas para relatórios sem dados de amostra:

  • Solicitações de criação de relatórios sem dados de amostra são consideradas na cota geral de solicitações de criação.
  • A API usa o mesmo sistema de token por propriedade e por dia usado ao criar um relatório sem dados de amostra por meio da interface da Web.

Permissão do usuário

Esta cota é específica para permissões do usuário:

  • 100 contas vinculadas por usuário.

Esses limites são aplicáveis a permissões de usuários em solicitações de criação em lote (delete, insert, update)

  • 300 solicitações de permissões de usuários por solicitação em lote.
  • 30 solicitações de permissão de usuários em lote são contabilizadas como 1 solicitação de criação.

API de aprovisionamento

Solicitações de criação

Esta cota se aplica a solicitações de gravação (por exemplo, createAccountTicket) para a API de aprovisionamento:

  • 50 solicitações por projeto e por dia.

APIs de geração de relatórios

Estas cotas se aplicam a todas as APIs de relatórios, incluindo a API de relatórios principais, a API em tempo real, a API de relatórios de funis multicanal V3 e a API de relatórios V4 do Google Analytics:

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

Erros de relatórios

Esta cota se aplica às solicitações de relatórios com falha (5XX):

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

Limites de cota excedentes

Se a cota for excedida, a Google Analytics API retornará um erro para solicitações adicionais (HTTP status code 403 Forbidden) e uma mensagem indicando que a conta específica não possui cota suficiente para prosseguir. Consulte os Termos de Serviço para mais informações.

Solicitação de cotas adicionais

Só é possível solicitar aumentos de cota para o número de solicitações diárias do projeto e solicitações diárias de criação. Se você acha que seu aplicativo precisa de uma cota diária adicional, pode solicitar um aumento da cota seguindo as instruções abaixo.

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.

Certifique-se de revisar as informações e seguir as instruções no formulário de solicitação de cota antes de enviar uma solicitação de aumento. Para a API de relatórios V4, o nome da API no Developers Console é API de relatórios V4 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 no Developers Console com um único nome de API: Google Analytics API.

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