Se aplican los siguientes límites y cuotas a la API de Data.
Cómo se aplican las cuotas
Todas las solicitudes a la versión 1 de la API de Google Analytics Data 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 realiza la llamada, 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 cuatro categorías de cuota de solicitudes: Core, Realtime, Funnel y Chat.
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. Las solicitudes a la API para los métodos de Funnel consumen cuotas de Funnel. Las solicitudes a la API para los métodos de Chat consumen cuotas de Chat. Cada solicitud consume solo un tipo de cuota.
| Categoría de cuota | Métodos de la API |
|---|---|
| Núcleo | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| Tiempo real | runRealtimeReport |
| Embudo | runFunnelReport |
| Chat | properties.chat |
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 propiedades de Analytics 360 |
|---|---|---|
| Tokens de Core por propiedad y por día | 200,000 | 2,000,000 |
| Tokens de Core por propiedad y por hora | 40,000 | 400,000 |
| Tokens de Core 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 en tiempo real por propiedad y 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 del servidor en tiempo real 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, por propiedad y por hora | 14,000 | 140,000 |
| Solicitudes simultáneas del embudo por propiedad | 10 | 50 |
| Errores del servidor de embudo por proyecto, propiedad y hora | 10 | 50 |
| Tokens de chat por propiedad y por día | 3,750,000 | 3,750,000 |
| Tokens de chat por propiedad y por hora | 500,000 | 500,000 |
- 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 tanto para los tokens por propiedad por hora como para 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 que la cuota de "Tokens por proyecto por propiedad por hora".
Las propiedades pueden enviar 120 solicitudes potencialmente con umbral por hora. Las dimensiones userAgeBracket, userGender, brandingInterest, audienceId y audienceName pueden estar sujetas a umbralización. Se aplican umbrales para evitar que las personas que vean 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 consumirán 10 tokens o menos, las solicitudes más complejas (como las consultas de Analytics Advisor chat) consumirán más.
Factores que influyen en el consumo de tokens
El costo exacto del token para una solicitud se determina en el momento de la ejecución, lo que dificulta el cálculo previo preciso. El costo se ve afectado 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: 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: Consultas sobre 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.
Supervisión y consumo de tokens de chat
En el caso de las solicitudes de Analytics Advisor chat, los tokens representan los costos de cálculo del modelo, razonamiento y recuperación de datos subyacentes. El consumo de tokens de chat se ve influenciado por los siguientes factores:
- Alcance analítico y de la consulta: Complejidad y amplitud del análisis solicitado
- Tokens de entrada y salida del modelo: Volumen de datos contextuales procesados y narrativa de respuesta generada.
- Tokens de pensamiento: Son los pasos de razonamiento del modelo necesarios para sintetizar los hallazgos.
- Latencia de ejecución: Es el tiempo de procesamiento necesario para las exploraciones de datos de varios pasos.
Para supervisar el uso de tokens de chat, establece "returnPropertyQuota": true en tu ChatRequest. La respuesta incluirá el objeto PropertyChatQuota que contiene los campos tokensPerDay y tokensPerHour con los saldos consumidos y restantes.