Empieza con CLASP: Configuración sencilla de Google Apps Script

Nota: Este artículo se publicó originalmente en el foro de nuestra comunidad.

¿Quieres mejorar tu desarrollo de Google Apps Script? Conoce CLASP-Command Line Apps Script, la herramienta que te permite escribir y gestionar tus proyectos de Google Apps Script de forma local en tu equipo, con la potencia del control de versiones y las prácticas de desarrollo modernas.

En esta guía rápida, te guiaremos a través de los pasos necesarios para poner en marcha CLASP y empezar a programar como un profesional en un abrir y cerrar de ojos.

Paso 1: Instalar Node.js y NPM

Antes de poder instalar CLASP, necesitas tener Node.js y NPM (Node Package Manager) instalados en tu máquina.

1. Descargar e instalar Node.js

• Ir a laSitio web oficial de Node.jsy descarga la última versión estable para tu sistema operativo.
• Siga las instrucciones de instalación y asegúrese de que NPM está instalado junto con Node.js. NPM suele venir incluido con Node.js, por lo que debería estar todo listo una vez completada la instalación.

2. Verificar la instalación

• Abra su interfaz de línea de comandos (CLI) y escriba los siguientes comandos para comprobar si Node.js y NPM están instalados: bashnode -v npm -v

• Si la instalación es correcta, ambos comandos deberían devolver números de versión.

Paso 2: Instalar CLASP

Ahora que Node.js y NPM están instalados, puedes instalar CLASP globalmente en tu máquina.

1. Instalar CLASP

• En su CLI, escriba el siguiente comando: bash npm install -g @google/clasp
• Este comando instala CLASP globalmente, permitiéndole utilizarlo desde cualquier parte de su sistema.

2. Verificar la instalación

• Para confirmar que CLASP está instalado correctamente, ejecute el siguiente comando: bash clasp -v
• Debería ver el número de versión de CLASP, lo que indica que la instalación se ha realizado correctamente.

Paso 3: Configurar el proyecto de Google Apps Script

Ahora que CLASP está instalado, puedes configurar tu proyecto de Google Apps Script.

1. Autenticar CLASP con su cuenta de Google

• Ejecute el siguiente comando para iniciar sesión con su cuenta de Google: bash clasp login
• Se abrirá una ventana del navegador en la que se le pedirá que autentique CLASP con su cuenta de Google. Siga las instrucciones para permitir el acceso.

2. Crear un nuevo proyecto de Google Apps Script

• Para crear un nuevo proyecto, vaya al directorio deseado en la CLI y ejecute: bash clasp create -title “My New Project” -type standalone
• Sustituye “Mi nuevo proyecto” por el nombre del proyecto que desees. El indicador `-type standalone` indica que se trata de un script independiente, no vinculado a ningún documento, hoja de cálculo o formulario de Google en particular.

3. Extraer un proyecto de Google Apps Script existente (opcional)

• Si ya tienes un proyecto de Google Apps Script y quieres trabajar en él localmente, utiliza: bash clasp clone YOUR_SCRIPT_ID
• Sustituye `YOUR_SCRIPT_ID` por el ID del script de tu proyecto. Esto extrae el proyecto a su máquina local.

Paso 4: Empezar a codificar e introducir cambios

Una vez configurado el proyecto, puedes empezar a programar localmente y enviar los cambios a Google Apps Script.

1. Escriba su código localmente

• Utilice su editor de código favorito (como VS Code) para escribir su código Apps Script. Los archivos suelen guardarse como archivos `.gs` (Google Script) o `.js` (JavaScript).

2. Enviar cambios al script de Google Apps

• Una vez realizados los cambios localmente, puedes transferirlos a Google Apps Script ejecutando: bash clasp push
• Este comando carga los cambios locales en el editor de Google Apps Script.

3. Extraer cambios del script de Google Apps

• Si has realizado cambios directamente en el editor de Google Apps Script, transfiérelos a tu entorno local con: bash clasp pull
• Esto garantiza que sus archivos locales estén actualizados con los últimos cambios.

Paso 5: Despliegue su script

Una vez que estés satisfecho con tu script, puedes desplegarlo directamente utilizando CLASP.

1. Despliegue como aplicación web

• Para desplegar su script como una aplicación web, utilice el siguiente comando: bash clasp deploy -description “Despliegue inicial”
• Esto despliega la última versión de su script y le da una URL de despliegue.

2. Gestionar implantaciones

• Para ver todas las implantaciones o actualizar una existente, utilice: bash clasp deployments
• Este comando muestra todas las implantaciones activas y sus URL.

Conclusión

Con CLASP, la gestión de tus proyectos de Google Apps Script es más eficaz y escalable. Ahora puedes aprovechar el control de versiones, los entornos de desarrollo locales y los procesos de implantación sin problemas. Tanto si estás desarrollando un script complejo como si acabas de empezar, CLASP cambia las reglas del juego para los desarrolladores de Google Apps Script. ¿Está preparado para llevar su programación al siguiente nivel? Instale CLASP hoy mismo y empiece a explorar las infinitas posibilidades que ofrece.