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
ouquotaUser
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):
- Limites do Analytics 360 para o modo de importação de tempo de processamento:
- 1 TB por propriedade
- 20 GB por conjunto de dados
- Limites do Analytics 360 para o modo de importação de tempo de consulta:
- 1 GB por propriedade
- 1 GB por conjunto de dados
- Limites padrão:
- 10 GB por propriedade
- 10 GB por conjunto de dados
- Limites do Analytics 360 para o modo de importação de tempo de processamento:
- 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.
- 100 MB por data (
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:
- o número de solicitações diárias de leitura por projeto (50.000 como padrão);
- o número de solicitações diárias de gravação por projeto (50 como padrão).
Para conferir ou mudar os limites de uso do projeto ou solicitar um aumento da cota, siga estas etapas:
- Se você ainda não tem uma conta de faturamento para o projeto, crie uma.
- Acesse a página "APIs ativadas" da biblioteca de APIs no Console de APIs e selecione uma API da lista.
- 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.