Cada solicitud a la API verifica que las cuotas no se hayan agotado y las consume. Si se agota una cuota, la solicitud falla con un mensaje de error relevante. Cada solicitud a la API de datos verifica varios buckets de cuota.
Categorías de cuota
A los efectos de la cuota, la API de datos tiene tres categorías de solicitudes: Core, Realtime y Funnel. Las solicitudes a la API a los métodos principales cobran cuotas de Core. Las solicitudes a la API dirigidas a métodos en tiempo real cobran cuotas en tiempo real. Una solicitud no consumirá las cuotas de Core y Realtime. Estos son los métodos y las categorías de la API:
| Categoría de la cuota | Métodos de la API |
|---|---|
| Núcleo | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility y createAudienceExports |
| En tiempo real | runRealtimeReport |
| Embudo | runFunnelReport |
Cuotas de propiedades de Analytics
Todas las solicitudes consumen cuotas de propiedad.
| Nombre de la cuota | Límite de propiedad estándar | Límite de propiedades de Analytics 360 |
|---|---|---|
| Tokens principales por propiedad y por día | 200,000 | 2,000,000 |
| Tokens principales por propiedad y por hora | 40,000 | 400,000 |
| Tokens principales por proyecto, por propiedad y por hora | 14 000 | 140,000 |
| Solicitudes simultáneas principales por propiedad | 10 | 50 |
| Errores de servidor principal por proyecto, por propiedad y por hora | 10 | 50 |
| Tokens en tiempo real por propiedad y por día | 200,000 | 2,000,000 |
| Tokens en tiempo real por propiedad y por hora | 40,000 | 400,000 |
| Tokens en tiempo real por proyecto, propiedad y por hora | 14 000 | 140,000 |
| Solicitudes simultáneas en tiempo real por propiedad | 10 | 50 |
| Errores de Realtime Server por proyecto, por propiedad y por hora | 10 | 50 |
| Tokens del embudo por propiedad y por día | 200,000 | 2,000,000 |
| Tokens de embudo por propiedad y por hora | 40,000 | 400,000 |
| Tokens de embudo por proyecto, propiedad y por hora | 14 000 | 140,000 |
| Embudo de solicitudes simultáneas por propiedad | 10 | 50 |
| Errores de servidor del embudo por proyecto, por propiedad y por hora | 10 | 50 |
- Las solicitudes simultáneas se miden por la cantidad de solicitudes que se ejecutan en simultáneo. Para reducir la simultaneidad de solicitudes, espera a que se completen las solicitudes anteriores antes de enviar solicitudes adicionales.
- Los errores de servidor son los códigos 500 y 503. Las cuotas de errores de servidor solo se cobran cuando una solicitud es Errores de servidor. Cuando se agotan las cuotas de errores de servidor de un par de proyecto y propiedad, se bloquean todas las solicitudes a la propiedad del proyecto.
- Cada solicitud consume la cuota de tokens por propiedad y por hora, y de tokens por proyecto, por propiedad y por hora. Esto significa que se debe acceder a una propiedad desde más de 3 proyectos antes de que se agote la cuota “Tokens por propiedad, por hora” antes de que se agote la cuota de “Tokens por proyecto, por propiedad y por hora”.
Las propiedades tienen permitido 120 solicitudes potencialmente limitadas por hora. Es posible que las dimensiones userAgeBracket, userGender, brandingInterest, audienceId y audienceName tengan un umbral. Se aplican umbrales para evitar que las personas que vean un informe identifiquen los datos demográficos o los intereses de usuarios individuales.
Cuota de tokens de propiedad
Los tokens se calculan con cada solicitud según la complejidad de completarla. La mayoría de las solicitudes cobrarán 10 tokens o menos. Cuando una solicitud consume una gran cantidad de tokens de cuota, se suelen tener en cuenta los siguientes factores:
- Gran cantidad de filas
- Gran cantidad de columnas
- Criterios de filtro complejos
- Período largo
Con cada solicitud a la API, puedes especificar "returnPropertyQuota": true en el cuerpo de la solicitud para mostrar el estado actual de los tokens de cuota de propiedad. Este estado contiene la cantidad que consume esta solicitud y la cantidad restante para cada grupo de cuotas. Por ejemplo, considera especificar este parámetro en RunReportRequest.