Cada solicitud a la API verifica que las cuotas no se hayan agotado y que 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 cuotas
A los efectos de la cuota, la API de datos tiene tres categorías de solicitud: Core, Realtime y Funnel. Las solicitudes a la API a los métodos Core cobran las cuotas de Core. Las solicitudes a la API para los 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 cuota | Métodos de la API |
|---|---|
| Core | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility y createAudienceLists |
| En tiempo real | runRealtimeReport; |
| Embudo | runFunnelReport |
Cuotas de las propiedades de Analytics
Todas las solicitudes consumen cuotas de propiedad.
| Nombre de la cuota | Límite de propiedad estándar | Límite de las propiedades de Analytics 360 |
|---|---|---|
| Tokens principales por propiedad por día | 200,000 | 2,000,000 |
| Tokens principales por propiedad, por hora | 40,000 | 400,000 |
| Tokens principales por proyecto, por propiedad, por hora | 14.000 | 140,000 |
| Solicitudes simultáneas principales por propiedad | 10 | 50 |
| Errores principales del servidor por proyecto, por propiedad y por hora | 10 | 50 |
| Tokens en tiempo real por propiedad por día | 200,000 | 2,000,000 |
| Tokens en tiempo real por propiedad, por hora | 40,000 | 400,000 |
| Tokens en tiempo real por proyecto, por 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 por día | 200,000 | 2,000,000 |
| Tokens del embudo por propiedad, por hora | 40,000 | 400,000 |
| Tokens del embudo por proyecto, por propiedad y por hora | 14.000 | 140,000 |
| Solicitudes simultáneas del embudo por propiedad | 10 | 50 |
| Errores de servidor de embudo por proyecto, por propiedad y por hora | 10 | 50 |
- Las solicitudes simultáneas se miden por la cantidad de solicitudes que se ejecutan simultáneamente. Para reducir la simultaneidad de solicitudes, espera a que se completen las solicitudes anteriores antes de enviar solicitudes adicionales.
- Los errores de servidor son códigos 500 y 503. Las cuotas de errores del servidor solo se cobran cuando se solicita un error del servidor. Cuando se agotan las cuotas de errores de servidor para un par de proyectos y propiedades, se bloquean todas las solicitudes a la propiedad del proyecto.
- Cada solicitud consume la cuota de tokens por propiedad, por hora y 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 la cuota “Tokens por propiedad, por hora” se agote antes de la cuota “Tokens por proyecto, por propiedad por hora”.
Las propiedades pueden tener 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 cualquier persona que vea un informe infiera los datos demográficos o intereses de usuarios individuales.
Cuota de tokens de propiedad
Los tokens se calculan con cada solicitud según la complejidad de la solicitud para completarla. La mayoría de las solicitudes cobrarán 10 tokens o menos. Cuando una solicitud consume una gran cantidad de tokens de cuota, estos factores suelen ser responsables:
- Gran cantidad de filas
- Gran cantidad de columnas
- Criterios de filtro complejos
- Período extenso
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 consumida por esta solicitud y la cantidad restante para cada grupo de cuotas. Por ejemplo, considera especificar este parámetro en RunReportRequest.