La API de GA4 permite sacar datos de Analytics sin entrar cada día al panel: informes automáticos, cuadros de mando propios o cargas periódicas a una hoja de cálculo. Sirve tanto a quien coordina el marketing de varias marcas o sedes como al equipo técnico que programa la extracción. No es un grifo abierto: cada propiedad tiene una cuota de tokens que se agota si se piden demasiados datos o consultas demasiado complejas, y quedarse sin cuota a media tarde deja los informes en blanco hasta el día siguiente.
La API de datos de GA4 (Google Analytics Data API) es la vía programática para consultar las mismas métricas y dimensiones del panel de Analytics desde código propio, sujeta a una cuota diaria de tokens que limita cuántas peticiones puede hacer cada propiedad.
La API de GA4 frente al panel estándar
La API de GA4 (Google Analytics Data API) da acceso a las mismas métricas y dimensiones que el panel, pero por código: se puede pedir sesiones por canal, conversiones por producto o eventos por país sin abrir el navegador, y programar esa consulta para que corra sola cada mañana. Eso cambia el uso según quién lo maneje. Un responsable de marketing que gestiona cuentas de varios sectores, desde retail hasta industrial, necesita comparar el mismo indicador entre propiedades sin repetir el proceso manual en cada una. Un equipo técnico, en cambio, integra la API en un pipeline propio, junto a otras fuentes, para construir un cuadro de mando único. El panel estándar de Analytics no distingue entre ambos usos: enseña lo mismo a todo el mundo. La API, en cambio, entrega justo los campos que pide cada consulta, lo que reduce el tiempo de proceso pero traslada la responsabilidad de vigilar la cuota a quien programa la extracción.
Tokens y cuota diaria por propiedad
Cada propiedad estándar de GA4 dispone de 200.000 tokens al día y 40.000 por hora; las propiedades Analytics 360 multiplican esa cifra por diez, según la referencia oficial de cuotas de la Data API de Google. El sistema comprueba varias cuotas a la vez antes de responder cada petición:
- Tokens por propiedad al día: el límite duro que corta el servicio hasta el día siguiente.
- Tokens por propiedad a la hora: evita que una sola integración agote de golpe la cuota diaria.
- Tokens por proyecto y propiedad a la hora: limita a cada aplicación conectada, no solo a la propiedad.
- Peticiones simultáneas: 10 en propiedades estándar, 50 en Analytics 360.
- Errores de servidor por hora: una integración mal configurada que falla en bucle también consume cuota.
La mayoría de peticiones sencillas gastan menos de 10 tokens, pero una consulta con muchas filas o con periodos largos puede llegar a 50 o más, así que la cuota diaria da para bastantes menos informes automáticos de lo que parece a primera vista.
Consultas complejas que disparan el gasto de tokens
El coste de una petición depende de su complejidad, no de si es «una consulta más». La Data API acepta como máximo 9 dimensiones y 10 métricas por informe, según su esquema de dimensiones y métricas, y cuantas más combine una consulta, más cara sale en tokens. También pesa el rango de fechas y la cardinalidad: cruzar página de destino con ciudad y dispositivo en un ecommerce con miles de referencias multiplica las filas que la API tiene que calcular antes de devolver la respuesta.
Diez peticiones cortas frente a una consulta larga
Google lo explica con un ejemplo claro en su guía de gestión de cuota de la Data API: pedir el mismo rango de fechas en cinco tramos de dos días puede consumir hasta tres veces más tokens que pedirlo de una sola vez en un tramo de diez días. La razón es que cada petición paga un coste fijo de proceso además del coste variable por fila devuelta, así que trocear una consulta multiplica ese coste fijo. Para un equipo que automatiza el informe semanal de varias filiales o sectores, la diferencia práctica es notable: encadenar una petición por filial y por día agota la cuota horaria mucho antes que una única consulta con la filial como dimensión y el rango completo de una vez. La recomendación de Google es agrupar por dimensión en lugar de por llamada, y guardar en caché lo que no cambia entre ejecuciones, en vez de volver a pedirlo cada vez que alguien abre el cuadro de mando.
Automatizar informes con la API de GA4
La API de GA4 tiene tres usos habituales en un equipo que ya no quiere depender de exportar CSV a mano. El primero es el envío automático de un correo con las cifras de la semana, montado con Apps Script sobre una hoja de cálculo. El segundo es un script en Python o Node que compara periodos y sectores y avisa solo cuando algo se sale del rango esperado, útil para negocios con varias líneas de actividad que no quieren revisar cada propiedad por separado. El tercero es alimentar un cuadro de mando propio que junte GA4 con otras fuentes, como el CRM o la plataforma de anuncios, algo que un servicio de analítica web suele montar una vez y dejar corriendo solo. Antes de automatizar nada conviene decidir qué cuota puede permitirse cada informe: un cuadro de mando que se actualiza cada minuto agota la cuota horaria en poco tiempo si lo usan varias personas a la vez.
Looker Studio, Sheets y BigQuery como salida
Fuera del código a medida, hay tres salidas ya construidas que consumen la misma cuota. El conector nativo de Looker Studio lee la API en directo cada vez que alguien abre el informe. El complemento de Sheets para Analytics trae los datos a una hoja de cálculo con la periodicidad que se configure. Y la exportación a BigQuery, cubierta ya en el límite de eventos diarios de la exportación gratuita, saca los datos en bruto una vez al día y evita depender de la cuota de la Data API para consultas repetidas.
El conector de Looker Studio y su caché de 12 horas
Looker Studio no guarda los datos: cada persona que abre el informe dispara una petición nueva contra la Data API, así que un cuadro de mando compartido con todo el equipo comercial puede agotar la cuota horaria solo con las visitas. La página de historial de cuota de Analytics permite comprobar cuánto se ha consumido y cuándo se produjeron los picos. Elevar el intervalo de caché del conector a 12 horas, el máximo disponible, reduce ese consumo porque la primera consulta del día guarda la respuesta y el resto de visitas la reutilizan en lugar de volver a preguntarle a la API. Revisar ese historial también ayuda a decidir si conviene pasar a una consultoría digital que reparta las consultas entre varias propiedades o proyectos.
Preguntas frecuentes sobre la API de GA4
¿Necesito saber programar para usar la API de GA4?
Para conectarla a Looker Studio o Sheets no hace falta código, basta con autorizar el conector. Para automatizar correos, comparativas entre sectores o cuadros de mando propios sí hace falta un script, normalmente en Python, Node o Apps Script, que llame a la API con las credenciales de la propiedad.
¿La API de GA4 tiene coste aparte de Analytics?
No, el acceso está incluido en cualquier propiedad de GA4, tanto estándar como 360. Lo único que se paga aparte es la infraestructura donde corra el script o el servicio que se use para programarlo, no la consulta a la API en sí.
¿Qué pasa si supero la cuota diaria?
La API devuelve un error de cuota agotada y deja de responder a esa propiedad hasta que se reinicia el contador, a medianoche hora del Pacífico. El panel estándar de Analytics sigue funcionando con normalidad porque usa una cuota distinta a la de la Data API.
¿Sirve la API de GA4 para tiempo real?
Sí, pero con un método aparte, runRealtimeReport, que tiene su propia cuota independiente de la de informes históricos. Sirve para paneles que muestran usuarios activos ahora mismo, no para el análisis de periodos largos, que conviene resolver con el método estándar.
Fuente: Google for Developers – Data API de Google Analytics (PropertyQuota)