En este tutorial te voy a mostrar cómo escribir datos en una celda de Google Sheets utilizando Google Apps Script, es decir, cómo crear tu primer código que automatiza la escritura de información directamente en tu hoja de cálculo. Aprenderás paso a paso cómo conectarte a tu archivo, seleccionar la hoja y el rango donde quieres escribir, y finalmente ejecutar el script. Este es el primer paso fundamental para automatizar tareas y aprovechar al máximo las macros y scripts personalizados en Google Sheets. Si eres principiante, este método te permitirá empezar a programar tus propias automatizaciones y ganar tiempo en tareas repetitivas.
Si prefieres ver el tutorial en video, aquí te lo dejo para que sigas el paso a paso visualmente. Ahora, vamos a detallar cada parte del proceso para que puedas replicarlo en tu propia hoja de cálculo.
¿Cómo escribir datos en Google Sheets usando Apps Script?
El objetivo es que puedas escribir un texto o número en una celda específica de tu hoja de cálculo con solo ejecutar una función. Este método es la base para automatizar procesos más complejos en el futuro, como copiar tablas, procesar datos o generar reportes automáticamente.
Paso a paso para crear tu primer script que escribe en una celda
1. Abre el editor de secuencias de comandos
Desde tu hoja de Google Sheets, ve al menú Extensiones > Apps Script. Se abrirá el editor donde podrás escribir y guardar tus scripts. Por defecto, se crea un archivo llamado Código con una función básica llamada myFunction.
2. Renombra tu proyecto y tu función
Es importante ponerle un nombre descriptivo a tu proyecto y a la función. Por ejemplo, puedes llamarla holaMundo para este ejercicio. Esto te ayudará a identificar tu código en el futuro.
3. Conéctate al servicio de Google Sheets
El primer paso en cualquier script de Google Sheets es conectarse al servicio usando SpreadsheetApp. Esto se guarda en una variable para usarla después.
var servicio = SpreadsheetApp;Este es el primer nivel de conexión: el script ya sabe que va a trabajar con hojas de cálculo.
4. Accede al archivo activo de Google Sheets
Luego, necesitas conectarte específicamente al archivo (spreadsheet) en el que estás trabajando. Para eso usas:
var archivo = servicio.getActiveSpreadsheet();En Google Sheets, Spreadsheet se refiere al archivo completo, mientras que Sheet es cada pestaña dentro del archivo.
5. Selecciona la hoja activa
Ahora, selecciona la pestaña (sheet) donde quieres escribir el dato. Generalmente, usarás la hoja activa:
var hoja = archivo.getActiveSheet();Así, el script trabajará siempre sobre la pestaña en la que estés parado al ejecutar el código.
6. Selecciona el rango donde escribirás el dato
Decide en qué celda o rango quieres escribir. Por ejemplo, la celda A1:
var rango = hoja.getRange("A1");Si quieres escribir en varias celdas, puedes usar un rango como «A5:B10».
7. Escribe el valor en la celda o rango
Para poner un valor en la celda seleccionada, usa el método setValue:
rango.setValue("Pedro");Esto escribirá el texto Pedro en la celda A1. También puedes escribir un número, por ejemplo:
rango.setValue(5);Si seleccionaste un rango como «A5:B10», el método setValue pondrá el mismo valor en todas las celdas de ese rango.
8. Guarda y ejecuta tu script
Guarda tu proyecto y haz clic en el botón Ejecutar. La primera vez, Google te pedirá autorizar el script para que pueda modificar tu hoja de cálculo. Acepta los permisos para continuar.
Código completo de ejemplo
function holaMundo() {
var servicio = SpreadsheetApp;
var archivo = servicio.getActiveSpreadsheet();
var hoja = archivo.getActiveSheet();
var rango = hoja.getRange("A1");
rango.setValue("Pedro");
}Al ejecutar este código, verás que la celda A1 de la hoja activa se llena con el texto Pedro. Puedes modificar el texto o el rango según tus necesidades.
¿Cómo escribir en un rango de celdas?
Si quieres escribir el mismo valor en varias celdas, solo cambia el rango. Por ejemplo, para escribir «Pedro» en todas las celdas de A5 a B10:
var rango = hoja.getRange("A5:B10");
rango.setValue("Pedro");Esto rellenará todas las celdas seleccionadas con el mismo valor. Más adelante aprenderemos a usar setValues para colocar diferentes valores en cada celda del rango.
Conclusión
En este tutorial aprendiste cómo escribir datos en una celda o rango de Google Sheets usando Apps Script. Vimos cómo conectarnos al servicio, acceder al archivo, seleccionar la hoja y el rango, y finalmente escribir el valor deseado. Esta es la base para automatizar tareas en Google Sheets y, en próximas lecciones, veremos cómo leer datos y procesarlos antes de escribirlos. Si tienes dudas, puedes dejar tus preguntas y seguir aprendiendo con los siguientes videos.
Si quieres aprender a usar Google Forms y Google Sheets desde cero, te invito a tomar un curso gratis de 2 horas.