Cada solicitação de API verifica se as cotas não foram esgotadas e consome cotas. Se alguma cota se esgotar, a solicitação falhará com uma mensagem de erro relevante. Cada solicitação da API Data verifica vários buckets de cotas.
Categorias de cota
Para fins de cota, a API Data tem três categorias de solicitação: núcleo, tempo real e funil. As solicitações de API para os métodos principais cobram cotas de núcleo. As solicitações de API para métodos do Realtime cobram cotas de tempo real. Uma solicitação não vai consumir as cotas Core e Realtime. Estes são os métodos e categorias da API:
| Categoria da cota | Métodos de API |
|---|---|
| Base | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility e createAudienceExports |
| Em tempo real | runRealtimeReport |
| Funil | runFunnelReport |
Cotas de propriedades do Google Analytics
Todas as solicitações consomem cotas de propriedade.
| Nome da cota | Limite padrão de propriedades | Limite das propriedades do Google Analytics 360 |
|---|---|---|
| Tokens principais por propriedade e por 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 |
| Principais solicitações simultâneas por propriedade | 10 | 50 |
| Erros do servidor principal por projeto, propriedade e hora | 10 | 50 |
| Tokens em tempo real por propriedade e por dia | 200.000 | 2.000.000 |
| Tokens em tempo real por propriedade e por 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 do servidor em tempo real por projeto, propriedade e hora | 10 | 50 |
| Tokens de funil por propriedade e por 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 do funil por propriedade | 10 | 50 |
| Erros do servidor de funil por projeto, propriedade e hora | 10 | 50 |
- As solicitações simultâneas são medidas pelo número de solicitações executadas simultaneamente. Para reduzir a simultaneidade de solicitações, aguarde a conclusão das solicitações anteriores antes de enviar outras solicitações.
- Os erros de servidor são os códigos 500 e 503. As cotas de erros de servidor só são cobradas quando há erros de servidor de solicitação. Quando as cotas de erros de servidor se esgotam 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, por hora e 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 por hora" se esgote antes da cota de "Tokens por projeto, propriedade e hora".
As propriedades podem ter 120 solicitações potencialmente limitadas por hora. As dimensões userAgeBracket, userGender, brandingInterest, audienceId e audienceName podem estar limitadas. Os limites são aplicados para impedir que qualquer pessoa que visualize um relatório deduza as informações demográficas ou os interesses de usuários individuais.
Cota de tokens de propriedade
Os tokens são calculados com cada solicitação, dependendo da complexidade para ser concluída. A maioria das solicitações cobra 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
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 essa solicitação e o valor restante para cada grupo de cotas. Por exemplo, considere especificar esse parâmetro em
RunReportRequest.