Os limites e as cotas a seguir se aplicam à API Data.
Como as cotas são aplicadas
Todas as solicitações à API Google Analytics Data v1 exigem um projeto do Google Cloud e estão sujeitas às cotas descritas nesta página. As cotas são consumidas independente do método usado para identificar o projeto de chamada, incluindo:
- Solicitações autenticadas com credenciais do OAuth 2.0.
- Solicitações autenticadas usando apenas uma chave de API.
As chaves de API são usadas para associar uma solicitação a um projeto específico do Google Cloud para fins de cota e faturamento. Todas as chamadas de API feitas usando credenciais ou uma chave de API do seu projeto serão contabilizadas nas cotas aplicáveis do projeto e da propriedade do Google Analytics.
Categorias de cota
A API Data tem três categorias de cota de solicitação: principal, de tempo real e de funil. As solicitações de API para métodos principais cobram cotas principais. As solicitações de API para métodos do Realtime cobram cotas de tempo real. Cada solicitação consome apenas um tipo de cota.
| Categoria de cota | Métodos da API |
|---|---|
| Core | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| Em tempo real | runRealtimeReport |
| Funil | runFunnelReport |
Cotas de propriedade do Google Analytics
Todas as solicitações consomem cotas de propriedade.
| Nome da cota | Limite de propriedade padrão | Limite de propriedades do Analytics 360 |
|---|---|---|
| Tokens principais por propriedade e dia | 200.000 | 2.000.000 |
| Tokens principais por propriedade e hora | 40.000 | 400.000 |
| Tokens principais por projeto, propriedade e hora | 14.000 | 140.000 |
| Solicitações simultâneas principais por propriedade | 10 | 50 |
| Erros de servidor principais por projeto, propriedade e hora | 10 | 50 |
| Tokens em tempo real por propriedade e dia | 200.000 | 2.000.000 |
| Tokens em tempo real por propriedade e hora | 40.000 | 400.000 |
| Tokens em tempo real por projeto, propriedade e hora | 14.000 | 140.000 |
| Solicitações simultâneas em tempo real por propriedade | 10 | 50 |
| Erros de servidor em tempo real por projeto, propriedade e hora | 10 | 50 |
| Tokens de funil por propriedade e dia | 200.000 | 2.000.000 |
| Tokens de funil por propriedade e hora | 40.000 | 400.000 |
| Tokens de funil por projeto, propriedade e hora | 14.000 | 140.000 |
| Solicitações simultâneas de funil por propriedade | 10 | 50 |
| Erros de servidor de funil por projeto, propriedade e hora | 10 | 50 |
- As solicitações simultâneas são medidas pelo número de solicitações que estão sendo executadas ao mesmo tempo. Para reduzir a simultaneidade de solicitações, aguarde a conclusão das solicitações anteriores antes de enviar outras.
- Os erros de servidor são códigos 500 e 503. As cotas de erros do servidor só são cobradas quando uma solicitação resulta em um erro do servidor. Quando as cotas de erros de servidor são esgotadas para um par de projeto e propriedade, todas as solicitações à propriedade do projeto são bloqueadas.
- Cada solicitação consome cota para "Tokens por propriedade e hora" e "Tokens por projeto, propriedade e hora". Isso significa que uma propriedade precisa ser acessada por mais de três projetos para que a cota "Tokens por propriedade e hora" se esgote antes da cota "Tokens por projeto, propriedade e hora".
As propriedades podem fazer 120 solicitações potencialmente limitadas por hora. As dimensões userAgeBracket, userGender, brandingInterest, audienceId e audienceName podem ter um limite. Os limites são aplicados para impedir que alguém que visualiza um relatório infira as informações demográficas ou interesses de usuários individuais.
Cota de tokens de propriedade
Os tokens são calculados com cada solicitação, dependendo da complexidade dela. A maioria das solicitações cobra 10 tokens ou menos. Quando um grande número de tokens de cota é consumido por uma solicitação, os seguintes fatores costumam ser responsáveis:
- Grande número de linhas
- Grande número de colunas
- Critérios de filtro complexos
- Período longo
Em cada solicitação de API, é possível especificar "returnPropertyQuota": true no corpo da solicitação para retornar o status atual dos tokens de cota da propriedade. Esse status
contém o valor consumido por esta solicitação e o valor restante para
cada grupo de cota. Por exemplo, considere especificar esse parâmetro em
RunReportRequest.