El camino más corto desde la API hasta Google Sheets — registra cada llamada como una nueva fila, automáticamente

Hola, soy yeonghyeon, lidero el desarrollo de 3Min API.

Esta entrada nació de una petición que los operadores nos hacían una y otra vez: "Que los pedidos se vayan acumulando solos en una Google Sheet, fila por fila." Ya existían formas de unirlo todo con herramientas adicionales de automatización, pero añadir una herramienta más es en sí mismo una carga. Por eso incorporamos la integración con Google Drive y Sheets directamente dentro de 3Min API. Conectas tu cuenta de Google una vez y, a partir de ahí, cada llamada a la API añade una fila a tu propia hoja automáticamente.

Este artículo es una guía para quienes encuentran esta función por primera vez. Vamos a recorrer por qué necesitábamos esto, en qué se diferencia de hacerlo con una herramienta de automatización en medio, y hasta dónde puedes llegar hoy en cinco minutos. No hace falta conocimiento previo.

El verdadero problema detrás de "Que se acumule en una hoja, sin más"

El motivo por el que se quieren los datos en una hoja casi siempre es el mismo. Ver los ingresos de un vistazo, filtrar y ordenar a mano, pasárselo tal cual a un contador o a un equipo de marketing. Las hojas encajan con ese propósito mejor que cualquier otra herramienta, y no hay necesidad de mover los datos a otra parte. Es decir, la hoja es el destino — todo lo que haya en medio sobra.

Y aun así, conectar "los datos recibidos por API" con "mi hoja" resulta sorprendentemente complicado. Lo habitual es seguir esta ruta:

1. Recibes los datos en algo como 3Min API,
2. te registras en otra herramienta de automatización — Zapier, Make, n8n,
3. vuelcas los datos a esa herramienta vía webhook,
4. y esa herramienta, a su vez, añade una fila a Google Sheets.

Cuando funciona, funciona. Pero al operador le siguen tres cargas:

• Coste de herramientas — cada herramienta de automatización conlleva una suscripción mensual, y si crece el volumen de llamadas hay que escalar a planes más caros.
• Curva de aprendizaje — conectar nodos, construir disparadores y configurar la autenticación una vez más. Demasiados pasos solo para "añadir una fila de pedido."
• Riesgo de pérdida — si la herramienta de automatización está en mantenimiento o supera su límite de llamadas, los datos que llegan en ese momento pueden descartarse en silencio. Una fila ausente en la hoja no deja rastro de qué se perdió.

El último punto fue decisivo. Perder datos no es una simple molestia para un negocio — es un agujero en la contabilidad. Apoyar el negocio sobre la suposición de que la herramienta de automatización siempre está sana es difícil de sostener.

Por eso elegimos la respuesta directa — meter la integración con hojas dentro del producto

La solución fue clara: que no haya otra herramienta entre 3Min API y Google Drive. Conectas una cuenta de Google una vez, autorizas un único permiso en la pantalla de consentimiento y, a partir de ahí, cada llamada a la API añade una fila a una hoja de tu propio Drive. Sin herramienta de automatización, sin suscripción extra, sin configuración de disparadores.

Llamada externa → primero almacenada de forma segura en 3Min API → registrada automáticamente en Google Sheets. Ninguna herramienta de automatización entre medio.

Esto es lo que cambia cuando funciona así:

• Una sola herramienta basta. Toda la configuración se hace dentro de 3Min API.
• Los datos se guardan siempre con seguridad antes que nada. Antes de que se añada una fila a la hoja, la propia llamada queda registrada en los logs y archivos de 3Min API. El registro en hojas es un extra encima — no la línea de vida.
• Aunque falle, el original sobrevive. Los excesos temporales de cuota se reintentan automáticamente. Si los reintentos tampoco prosperan, en la hoja simplemente faltará una fila — los datos en sí no desaparecen.
• Permisos acotados. El único permiso que se solicita a Google es drive.file. 3Min API solo puede tocar las hojas que ha creado él mismo; el resto de tu Drive permanece intacto.

En resumen: si la hoja es el destino, el camino hacia ella debe ser lo más corto posible.

Lo que verás en tu Drive tras conectar

La forma más rápida de entenderlo es ver la estructura. En la raíz de tu Drive aparece una carpeta llamada 3Min API, organizada así:

3Min API/
├── user-signup/                              ← carpeta por endpoint
│   ├── sandbox_user-signup_2026-04           ← hoja mensual (sandbox)
│   ├── sandbox_user-signup_2026-05
│   └── production_user-signup_2026-05        ← hoja mensual (producción)
└── order-create/
    └── production_order-create_2026-05

La regla es simple: una carpeta por endpoint, con una hoja por entorno (sandbox/producción) y por mes. Una hoja nueva se crea automáticamente con la primera llamada de cada mes, así que ninguna hoja se vuelve demasiado pesada. Puedes mover hojas a otras carpetas o renombrarlas con seguridad — 3Min API rastrea los archivos por ID, así que aunque cambien la ubicación y el nombre, las nuevas filas siguen aterrizando en el mismo archivo.

La primera fila de cada hoja — la cabecera — tiene dos tipos de columnas:

• Columnas meta — record_id, created_at, config_version, operation, status, collaboration_key. Las rellena el sistema automáticamente. Te dicen qué llamada produjo esta fila.
• Columnas de payload — los campos que has definido (correo, importe, dirección…) aparecen con el prefijo payload_, una columna por campo. El prefijo está ahí a propósito, para que no se confundan datos de negocio con metadatos.

Cuando más adelante añades un campo nuevo al endpoint, la cabecera de la hoja se extiende automáticamente hacia la derecha. La columna nueva queda vacía en las filas anteriores y empieza a llenarse desde la siguiente llamada en adelante. Mientras no borres ni reordenes celdas de cabecera a mano, el mapeo se mantiene correcto.

Sandbox y producción se mueven por separado

Cada endpoint en 3Min API tiene entornos completamente separados de sandbox (desarrollo/pruebas) y producción (servicio real). La integración con Google Sheets sigue la misma separación. La integración se activa o desactiva de forma independiente por pestaña de entorno, y los archivos de hoja se crean por entorno por separado.

Esto da pie a una verificación de seguridad con la que te encontrarás a menudo. Aunque hayas conectado las hojas en sandbox y luego despliegues el endpoint a producción, la integración de hojas en producción no se traslada automáticamente. Tienes que pulsar Conectar una vez más en la tarjeta de Google Sheets de la pestaña de producción antes de que comience el registro real. Lo preguntamos dos veces a propósito — mezclar datos de prueba con datos reales de ingresos en una sola hoja es uno de los accidentes más complicados que pueden ocurrir.

Cinco minutos hasta tu primera fila en la hoja

Leer es una cosa; verlo funcionar es más rápido. El orden de abajo te lleva de cero a una pequeña tubería operativa. Sin código, sin herramientas extra — solo 3Min API.

1. Crea una cuenta y tu primer endpoint

Tras registrarte, una breve incorporación te guía para crear tu primer endpoint. La integración con Google Sheets está disponible incluso en el plan Free. Elige algo de tu negocio y crea un solo endpoint para probarlo. Cualquier cosa sirve. Para empezar, eventos sencillos que encajen en una fila — pedido recibido, consulta enviada, reserva solicitada — son lo que mejor funciona. Con dos o tres campos basta. El procedimiento completo está en el manual de creación de endpoints.

Si quieres dar un paso atrás y entender qué es un endpoint en primer lugar, ¿Qué es una API? Una guía para quienes no son desarrolladores es el mejor punto de entrada. Una vez que captes la sensación de "una ventanilla definida por la que fluyen mensajes con una forma definida", lo demás viene solo.

2. Inicia la integración desde la tarjeta de Google Sheets

En la página de detalle del endpoint verás una tarjeta llamada Google Sheets. Al pulsar Conectar en esa tarjeta se te lleva a la pantalla de consentimiento de Google.

El único permiso que solicita 3Min API es drive.file — un permiso acotado que solo le permite a la aplicación tocar las hojas que ella misma ha creado. Si Google muestra casillas individuales por permiso, por favor déjalas todas marcadas al aprobar; de lo contrario el registro en hojas no funcionará.

3. Confirma con un envío de prueba

Una vez conectado, la tarjeta muestra el distintivo Conectado junto al nombre del archivo de la hoja. Pulsa Envío de prueba una vez. Una fila de muestra se añade a la hoja para que veas exactamente cómo aparece una llamada cuando aterriza. Es la forma más rápida de confirmar todo el flujo de extremo a extremo sin herramientas de desarrollo.

Desde ahora, cada llamada a este endpoint añade una nueva fila a la hoja. Eso es todo.

Cosas que conviene saber

Google Sheets tiene su propia cuota de escritura

Las escrituras a la hoja están sujetas al límite de escritura por usuario que fija Google, no a un límite de 3Min API. Es de aproximadamente 60 escrituras por minuto, y todos los endpoints conectados a la misma cuenta de Google comparten esa cuota. Imagina toda la integración como algo que se mueve sobre ese único techo.

Con tráfico normal rara vez notarás este límite. Con el tiempo, sin embargo, si las llamadas crecen de forma sostenida y empiezas a chocar con él más a menudo, en realidad es una buena señal — tu negocio está creciendo. Como las políticas de Google dificultan elevar la cuota por usuario, en ese punto es prudente usar la hoja con fines de resumen/panel, descargar los originales diaria o semanalmente desde Logs y Archivos, y considerar introducir tu propia base de datos. 3Min API sigue sirviendo como pasarela de entrada en esa etapa, así que la migración apenas implica carga operativa.

Puedes mantenerte al tanto con notificaciones del sistema

Para que reacciones de inmediato cuando una escritura en hoja falle o haga falta una reautenticación, puedes registrar un canal de Discord/Slack/Telegram por endpoint. Conecta un canal una vez en los ajustes de notificación de Detalle del endpoint, y los dos eventos — fallo de escritura en la hoja y reautenticación de Google requerida — se envían directamente a ese canal. Es la forma más ligera de confirmar que las hojas se están llenando correctamente sin asomarte al panel cada vez.

Lo que 3Min API maneja silenciosamente mientras tanto

Los eventos que dispararían una notificación no ocurren a menudo. El espacio entre medio lo cubre 3Min API de tres maneras:

• Reintento automático — los excesos temporales de cuota (429) y los fallos puntuales se reintentan durante unos 5 minutos, absorbiendo la mayoría. Además seguimos solicitando aumentos de cuota a Google para ampliar el rendimiento con el tiempo.
• El original siempre está a salvo — incluso cuando los reintentos finalmente no llegan, solo falta una fila en la hoja; la llamada original se conserva en Logs y Archivos. Una escritura fallida no significa datos perdidos.
• Procesado en orden de llamada, una fila a la vez — el registro en hojas sigue el orden de llamada, y las filas suelen aparecer en pocos segundos. Durante picos de tráfico, las filas pueden aterrizar más tarde de lo habitual o ligeramente fuera de orden; si necesitas un orden exacto, ordena la hoja por la columna created_at.

Una cosa que puedes probar hoy

No hace falta montar una gran tubería de automatización de golpe. Lo único que merece la pena probar primero es esto:

Crea tu primer endpoint → activa la integración con Google Sheets → pulsa Envío de prueba una vez.

Solo con eso ya tienes una pequeña tubería que empieza a apilar datos de tu negocio en tu propio Drive automáticamente. A partir de ahí, puedes añadir campos, entregarle una API key a un socio o trazar un gráfico con la columna de ingresos. En vez de diseñar toda la automatización por adelantado, es mejor ver una fila aterrizar en la hoja por el camino más corto posible primero.

Para ajustes más avanzados y casos límite, el manual de integración con Google Sheets lo recoge todo. Si te gustaría escuchar por qué construimos esto en primer lugar, Por qué construimos 3Min API cuenta esa historia.