Se aplican los siguientes límites y cuotas a la API de Data.
Cómo se aplican las cuotas
Todas las solicitudes a la API de Google Analytics Data v1 requieren un proyecto de Google Cloud y están sujetas a las cuotas que se describen en esta página. Las cuotas se consumen independientemente del método que se use para identificar el proyecto que llama, incluidos los siguientes:
- Solicitudes autenticadas con credenciales de OAuth 2.0.
- Solicitudes autenticadas solo con una clave de API.
Las claves de API se usan para asociar una solicitud con un proyecto de Google Cloud específico para fines de cuota y facturación. Todas las llamadas a la API que se realicen con credenciales o una clave de API de tu proyecto se contabilizarán en las cuotas aplicables de tu proyecto y de la propiedad de Google Analytics.
Categorías de cuotas
La API de datos tiene tres categorías de cuota de solicitudes: Core, Realtime y Funnel. Las solicitudes de API a los métodos de Core consumen cuotas de Core. Las solicitudes a la API para los métodos de Realtime consumen cuotas de Realtime. Cada solicitud consume solo un tipo de cuota.
| Categoría de cuota | Métodos de la API |
|---|---|
| Core | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| Tiempo real | runRealtimeReport |
| Embudo | runFunnelReport |
Cuotas de propiedad 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 de Core por propiedad y por día | 200,000 | 2,000,000 |
| Tokens de núcleo por propiedad y por hora | 40,000 | 400,000 |
| Tokens de núcleo por proyecto, por propiedad y por hora | 14,000 | 140,000 |
| Solicitudes simultáneas principales por propiedad | 10 | 50 |
| Errores principales del servidor por proyecto, propiedad y hora | 10 | 50 |
| Tokens en tiempo real por propiedad y por día | 200,000 | 2,000,000 |
| Tokens por propiedad por hora en tiempo real | 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 del servidor en tiempo real por proyecto, propiedad y hora | 10 | 50 |
| Tokens de 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 hora | 14,000 | 140,000 |
| Solicitudes simultáneas del embudo por propiedad | 10 | 50 |
| Errores del servidor del embudo por proyecto, propiedad y hora | 10 | 50 |
- Las solicitudes simultáneas se miden según la cantidad de solicitudes que se ejecutan de forma simultánea. Para reducir la simultaneidad de las solicitudes, espera a que se completen las solicitudes anteriores antes de enviar solicitudes adicionales.
- Los errores del servidor son los códigos 500 y 503. Las cuotas de errores del servidor solo se cobran cuando una solicitud genera un error del servidor. Cuando se agotan las cuotas de errores del servidor para un par de proyecto y propiedad, se bloquean todas las solicitudes a la propiedad desde el proyecto. Para obtener una lista completa de las respuestas de error, consulta Error Responses.
- Cada solicitud consume cuota para los tokens por propiedad por hora y los tokens por proyecto por propiedad por hora. Esto significa que más de 3 proyectos deben acceder a una propiedad antes de que se agote la cuota de "Tokens por propiedad por hora" antes de que se agote la cuota de "Tokens por proyecto por propiedad por hora".
Las propiedades pueden enviar 120 solicitudes potencialmente cerca del umbral por hora. Las dimensiones userAgeBracket, userGender, brandingInterest, audienceId y audienceName pueden tener umbrales. Se aplican umbrales para impedir que las personas que consulten un informe infieran los datos demográficos o los intereses de usuarios individuales.
Cuota de tokens de propiedad
Los tokens se consumen con cada solicitud a la versión 1 de la API de Google Analytics Data. La cantidad de tokens que se cobran depende de la complejidad de la solicitud. Si bien la mayoría de las solicitudes cobrarán 10 tokens o menos, las solicitudes más complejas consumirán más.
Factores que influyen en el consumo de tokens
El costo exacto de los tokens para una solicitud se determina en el momento de la ejecución, lo que dificulta el cálculo previo preciso. El costo se ve influenciado por una combinación de factores relacionados con la solicitud en sí y los datos subyacentes de la propiedad de Google Analytics. Estos factores pueden generar costos más altos:
- Cantidad de filas: Se solicita una mayor cantidad de filas.
- Cantidad de dimensiones y métricas: Incluye una mayor cantidad de dimensiones y métricas.
- Complejidad del filtro: Se emplean expresiones de filtro complejas.
- Duración del período: Se realizan consultas durante períodos más largos.
- Cardinalidad de los datos: Las dimensiones con alta cardinalidad (muchos valores únicos, como
pagePathy las dimensiones personalizadas) pueden aumentar significativamente el costo de los tokens. - Volumen de eventos de la propiedad: Las consultas en propiedades con un mayor volumen de eventos pueden consumir más tokens que la misma consulta en una propiedad con menos datos.
Supervisa el uso de tokens
La forma más eficaz de determinar el costo en tokens de tus llamadas a la API específicas es incluir el parámetro "returnPropertyQuota": true en el cuerpo de la solicitud.
La respuesta de la API incluirá el objeto PropertyQuota, que detalla los tokens consumidos por esa solicitud específica y los saldos de cuota restantes.