Os limites e cotas a seguir se aplicam à API Data.
Categorias de cota
A API Data tem três categorias de cota de solicitação: principal, de tempo real e funil. As solicitações de API para métodos do Core cobram cotas do Core. As solicitações de API para métodos de tempo real cobram cotas de tempo real. Cada solicitação consome apenas um tipo de cota.
| Categoria de cota | Métodos de API |
|---|---|
| Core | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| Em tempo real | runRealtimeReport |
| Funil | runFunnelReport |
Quotas da propriedade do Google Analytics
Todas as solicitações consomem cotas da propriedade.
| Nome da cota | Limite de propriedade padrão | Limite de propriedades do Google Analytics 360 |
|---|---|---|
| Tokens principais por propriedade e dia | 200.000 | 2.000.000 |
| Tokens de núcleo por propriedade e hora | 40.000 | 400.000 |
| Tokens de núcleo 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 do funil por projeto, propriedade e hora | 14.000 | 140.000 |
| Solicitações simultâneas por funil por propriedade | 10 | 50 |
| Erros de servidor do funil por projeto, propriedade e hora | 10 | 50 |
- As solicitações simultâneas são medidas pelo número de solicitações executadas ao mesmo tempo. Para reduzir a simultaneidade de solicitações, aguarde que as solicitações anteriores sejam concluídas antes de enviar outras.
- Os erros do servidor são os 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 para a propriedade do projeto são bloqueadas.
- Cada solicitação consome a cota de tokens por propriedade e hora e de tokens por projeto, propriedade e hora. Isso significa que uma propriedade precisa ser acessada por mais de três projetos antes que a cota de "Tokens por propriedade e hora" seja esgotada antes da cota de "Tokens por projeto e hora".
As propriedades podem fazer 120 solicitações com possível limitação por hora. As
dimensões userAgeBracket, userGender, brandingInterest, audienceId e
audienceName têm um limite mínimo. 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 vai cobrar 10 tokens ou menos. Quando um grande número de tokens de cota é consumido por uma solicitação, esses fatores geralmente são responsáveis:
- Grande número de linhas
- Grande número de colunas
- Critérios de filtro complexos
- Período longo
Com 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 essa solicitação e o valor restante para
cada grupo de cota. Por exemplo, considere especificar esse parâmetro em
RunReportRequest.