Cómo usar el editor de Google Apps Script: una guía completa para principiantes

Si alguna vez has necesitado automatizar tareas en Google Docs, Sheets, Analytics o Gmail, probablemente te hayas topado con Google Apps Script. Es un poco raro, pero básicamente es la versión de Google de VBA en Microsoft Office, pero en la nube. Puedes personalizar funciones, crear macros o incluso crear menús personalizados dentro de tus servicios de Google. Sinceramente, una vez que le coges el truco, es bastante potente. Sin embargo, explorar el editor y descubrir cómo conectarlo todo puede ser un poco intimidante al principio, sobre todo si no estás acostumbrado a programar ni a los IDE.

Lo realmente útil es saber cómo acceder al Editor de Apps Script, navegar por él y conectar otros servicios o API de Google. Una vez que domines esto, podrás automatizar un montón de tareas repetitivas y aumentar la productividad. Además, verás lo fácil que es añadir activadores personalizados, conectar bibliotecas o incluso compartir tus scripts. El objetivo es asegurarte de que sabes dónde está todo, qué hace y cómo empezar a escribir tus propios scripts que hagan todo el trabajo aburrido por ti.

Cómo acceder al editor de Google Apps Script

Acceda a él a través de Hojas de cálculo, Documentos, Presentaciones, Documentos o Drive de Google.

La mayoría de las personas acceden a Apps Script desde Hojas de Cálculo de Google, haciendo clic en Extensiones y luego en Apps Script. Pero si usas Documentos o Presentaciones de Google, los pasos son bastante similares: solo tienes que ir a Herramientas y seleccionar Editor de scripts. Para Formularios de Google, es un poco menos obvio: haz clic en los tres puntos de la esquina superior derecha y busca allí Editor de scripts. En Drive, haz clic derecho en un espacio en blanco, ve a Más y selecciona Google Apps Script. Ten en cuenta que en algunos casos, la interfaz puede parecer un poco anticuada o estar oculta tras los menús, especialmente en diferentes navegadores o en dispositivos móviles.

Una vez hecho esto, el editor de código se abre en una nueva pestaña. Ahí es donde ocurre la magia. Por defecto, verás una función básica llamada myFunction(), que es básicamente un marcador de posición. Puedes empezar a escribir tus propios scripts aquí; solo recuerda guardar regularmente haciendo clic en el icono de guardar (el disquete).Algunas configuraciones, sobre todo si tu conexión es lenta o tu navegador no funciona correctamente, podrían no guardarse automáticamente, así que guardar con frecuencia evita perder el progreso.

Si quieres cambiar entre scripts o archivos, busca el panel izquierdo: verás Code.gs por defecto, pero puedes añadir otros archivos.gs o HTML para proyectos avanzados. Pasa el cursor sobre los iconos para ver opciones como la sección «Resumen», que te informa sobre errores, recuentos de ejecuciones y otras estadísticas.¿No estás seguro de la función de una función? La documentación de Google es bastante buena, pero a veces la aplicación real tiene más matices que lo que se lee en línea.

Navegar por el editor de Google Apps Script

Barras de herramientas y menús que probablemente usarás mucho

Acostúmbrate a hacer clic en el icono de Guardar con frecuencia. Puede parecer trivial, pero en el entorno de la nube de Google, perder código no guardado puede arruinarte el día. Una vez guardado, el editor desbloquea opciones como Ejecutar (para ejecutar el script), Depurar (recorrer el código paso a paso, esencial cuando falla algo) y el menú desplegable Función (navegar entre los diferentes scripts que has escrito).

Otra función útil es el registro de ejecución : muestra errores, advertencias o confirmaciones de que tu script se ejecutó correctamente. Resulta útil, especialmente al depurar funciones complejas. Si quieres reutilizar código escrito en otro lugar, la pestaña Bibliotecas es tu mejor aliada: solo necesitas el ID del script, que es una larga cadena de caracteres que puedes copiar desde la pantalla de configuración del proyecto.

Conexión de servicios API y bibliotecas

En el menú Servicios, puedes añadir APIs de Google como Analytics, Drive, Calendar y más. Simplemente selecciona «Añadir un servicio», busca lo que necesitas y pulsa «Añadir».¡Listo! Ahora tu script puede llamar a esas API directamente. Por ejemplo, extraer datos de Google Analytics o Hojas de Cálculo, según lo requiera tu proyecto. Para más detalles, haz clic en los tres puntos junto a una API y selecciona » Ver documentación». Es una especie de agujero negro de información, pero vale la pena explorarlo si te apasiona la automatización.

Y, nota al margen: Explora la sección Bibliotecas para encontrar código reutilizable escrito por otros, especialmente si quieres evitar reinventar la rueda. Recuerda: necesitas el ID del script, que se encuentra en la configuración del proyecto: una larga cadena aleatoria de caracteres que copias y pegas en tu proyecto.

Uso de activadores para automatizar

Configúrelo y olvídese con los activadores

Si quieres que tu script se ejecute automáticamente a ciertas horas, esté atento a cambios o ante eventos específicos, ve a «Disparadores» en el menú de la izquierda. Haz clic en «Añadir disparador» y verás un formulario enorme para personalizar exactamente cuándo y cómo se activa tu script.¿Quieres que se ejecute cada mañana? Elige «Controlado por tiempo» y configúralo.¿Quieres que se active al cambiar una celda de la hoja de cálculo? Configura el tipo de evento como «Al editar».Esto te ahorra tener que ejecutar tareas manualmente si necesitan ejecutarse en segundo plano, algo esencial si gestionas informes automatizados o manipulas datos.

La primera vez que configures un disparador, podría aparecer el mensaje «Error de autorización de script», especialmente si tienes bloqueadores de ventanas emergentes activos. En Chrome, esto suele deberse al pequeño icono rojo en la barra de direcciones. Simplemente haz clic en él, permite las ventanas emergentes del sitio y vuelve a intentarlo. Google te pedirá que autorices el script; es bastante sencillo: solo sigue las instrucciones. Si creaste una función nueva, debes autorizarla para que el disparador funcione. El proceso implica seleccionar tu cuenta de Google y aceptar los permisos, lo cual es un poco tedioso, pero necesario.

Ah, y si ves una advertencia sobre que el script no se está verificando, es normal en scripts personalizados. Simplemente haz clic en «Avanzado» y luego en «Ir al proyecto (no seguro)».En tus propios scripts, suele ser bastante seguro. Después, al hacer clic en «Permitir», todo se autoriza. Una vez autorizados, los activadores se ejecutarán sin problemas, al menos hasta que vuelvas a cambiar los permisos.

Cómo localizar el ID de su script

Si necesitas compartir tu script o añadirlo como biblioteca en otro lugar, necesitarás el ID del script.¿Cómo encontrarlo? Simplemente haz clic en el icono del engranaje en la barra lateral izquierda, ve a Configuración y busca en la sección IDs. El ID del script aparecerá ahí, una larga cadena de caracteres. Cópialo y entrégalo o tenlo a mano para tus proyectos.

En resumen, Google Apps Script no es demasiado complicado una vez que sabes dónde está todo y para qué sirven las piezas principales. Vale la pena consultar la documentación oficial de Google, pero no te dejes intimidar por la sobrecarga. Una vez que te sientas cómodo, crear automatizaciones sencillas se vuelve muy fácil y las posibilidades son prácticamente infinitas.

---

---