Cómo conectar Google Sheets a tu app

Para conectar Google Sheets a tu app, activa la API de Google Sheets en un proyecto de Google Cloud, crea una cuenta de servicio, comparte la hoja de cálculo con la dirección de email de la cuenta de servicio y guarda su clave como secreto del lado del servidor. Tu servidor lee filas con spreadsheets.values.get y añade filas con spreadsheets.values.append. Si los usuarios necesitan conectar sus propias hojas, usa OAuth; y si la hoja es totalmente pública, para leerla basta una clave de API sencilla.

Esta guía cubre qué método encaja, las llamadas que necesitas, las cuotas y los detalles a tener en cuenta, y prompts para un creador de apps con IA. Los datos de Google proceden de su documentación para desarrolladores a septiembre de 2026.

Por qué conectar una hoja

Motivos habituales:

• Mantener el flujo de trabajo del equipo. El personal sigue editando una lista de precios o un calendario en Sheets; la app lo muestra.
• Recoger datos donde la gente ya mira. Los nuevos registros, pedidos o respuestas de formularios llegan como filas.
• Informes. Exporta datos de la app a una hoja para quien trabaja con hojas de cálculo.
• Un paso intermedio. Empieza con la hoja y luego pasa a una base de datos de verdad. Consulta cómo convertir una hoja de cálculo en una app.

Elige cómo se identifica tu app ante Google

La guía de credenciales de Google describe tres tipos:

Para la mayoría de las apps, una cuenta de servicio es la opción correcta: un único conjunto de credenciales, de tu propiedad, con acceso solo a las hojas que compartas explícitamente con ella.

Paso a paso con una cuenta de servicio

1. Crea o elige un proyecto de Google Cloud y activa la API de Google Sheets.
2. Crea una cuenta de servicio y una clave para ella. La clave es un archivo JSON; trátala como una contraseña.
3. Comparte la hoja de cálculo con la dirección de email de la cuenta de servicio, como lector si es solo lectura, o como editor si necesita escribir. La guía de Google indica que esto se hace desde la pantalla normal de uso compartido.
4. Guarda la clave como secreto en tu servidor, por ejemplo GOOGLE_SERVICE_ACCOUNT_JSON, y el ID de la hoja de cálculo (la cadena larga de la URL de la hoja) como SHEET_ID.
5. Llama a la API desde el servidor con la biblioteca cliente de Google para tu lenguaje.
6. Guarda las lecturas en caché si muchos visitantes ven los mismos datos, para no alcanzar la cuota.

Las llamadas que usarás

De la guía de Google para leer y escribir valores:

Los rangos usan la notación A1. Google señala que un rango sin nombre de hoja, como A1:B2, se aplica a la primera hoja, así que nombra la pestaña explícitamente para evitar sorpresas cuando alguien reordene las pestañas.

RAW frente a USER_ENTERED

Las escrituras necesitan un valueInputOption:

• RAW guarda exactamente lo que envías, como texto. =1+2 se guarda como el texto =1+2.
• USER_ENTERED trata la entrada como si se hubiera escrito en Sheets: las fechas se convierten en fechas y =1+2 se convierte en una fórmula.

Si escribes texto que los usuarios introdujeron en tu app, usa RAW. Con USER_ENTERED, alguien podría enviar una fórmula que se ejecute cuando un compañero abra la hoja.

Cuotas y errores

A septiembre de 2026, la página de límites de la API de Sheets de Google indica:

No hay límite diario mientras te mantengas dentro de las cuotas por minuto. Si te excedes, se devuelve 429: Too many requests (demasiadas solicitudes), y Google recomienda la espera exponencial truncada: esperar más tiempo tras cada intento fallido, con un retardo aleatorio, hasta un máximo. Una sola solicitud que tarde más de 180 segundos se cancela por tiempo de espera.

En la práctica: no llames a la API en cada visita a una página. Guarda los datos de la hoja en caché durante un minuto o más, agrupa las lecturas con batchGet y agrupa las escrituras cuando puedas.

Opciones y compromisos

Para cualquier cosa con muchos usuarios o datos sensibles, una base de datos es la mejor fuente de verdad. Consulta qué es una base de datos.

Prompts para tu creador de apps con IA

Leer una hoja:

Muestra la pestaña «Menú» de nuestra hoja de Google en la página del menú. Usa la API de Google Sheets desde el servidor con una cuenta de servicio cuya clave JSON está en el secreto GOOGLE_SERVICE_ACCOUNT_JSON, y el ID de la hoja en SHEET_ID. Lee el rango Menu!A2:D (nombre, descripción, precio, categoría). Guarda el resultado en caché durante 5 minutos. Si la API falla, muestra la última versión guardada. No envíes nunca la clave al navegador.

Escribir filas:

Cuando alguien envíe el formulario de contacto, guárdalo en nuestra base de datos y también añade una fila a la pestaña «Leads» (fecha, nombre, email, mensaje) usando spreadsheets.values.append con valueInputOption RAW. Si Google devuelve 429, reintenta con espera exponencial; si sigue fallando, mantén el lead en la base de datos y reintenta más tarde.

Errores habituales

• Olvidar compartir la hoja con el email de la cuenta de servicio. La API devuelve entonces un error de permisos aunque la clave sea correcta.
• La clave en el frontend o en el repositorio. La clave JSON da acceso a todas las hojas compartidas con ella. Consulta cómo mantener seguras las claves de API.
• Usar USER_ENTERED con la entrada de los usuarios, lo que permite la inyección de fórmulas.
• Llamar a la API en cada solicitud y alcanzar la cuota por minuto con el primer pico de tráfico.
• Depender de las posiciones de las columnas. Alguien inserta una columna y la app lee datos incorrectos. Lee la fila de encabezados y mapea por nombre, o bloquea el encabezado.
• Compartir la hoja más de lo necesario. «Cualquiera con el enlace» la hace pública.
• Usar una hoja como base de datos multiusuario. Las escrituras simultáneas y los permisos mal configurados provocan pérdidas o filtraciones de datos.

Lista de comprobación

• API de Sheets activada; cuenta de servicio creada
• Hoja compartida con el email de la cuenta de servicio con el permiso mínimo necesario
• Clave e ID de la hoja guardados como secretos del servidor
• Todas las llamadas hechas desde el servidor
• Nombres de pestaña usados en los rangos
• RAW usado para el texto que aportan los usuarios
• Lecturas en caché; errores 429 gestionados con espera exponencial
• La app sigue funcionando con elegancia si Sheets no está disponible
• Decidido qué lado es la fuente de verdad

Google Sheets en Mythex

Mythex tiene dos formas distintas de trabajar con Sheets. Los conectores vinculan tu cuenta de Google a Mythex para que el agente la use mientras construyes, por ejemplo para leer una hoja y construir un panel a partir de ella; según la documentación, la credencial permanece en el servicio de conexión de Mythex y nunca llega a tu código (consulta Conectores, y aprueba cada permiso que pida Google). Para que la app publicada lea o escriba una hoja por su cuenta, la vía fiable es la de esta guía: una clave de cuenta de servicio guardada como secreto del proyecto y llamadas a la API de Sheets desde tu servidor, tal como se explica en Integrar cualquier API. Si estás creciendo más allá de la hoja, pide al agente que mueva los datos a la base de datos del proyecto y que construya un panel encima.

Preguntas