Cómo conectar Google Apps Script a tu terminal Linux con CLASP

Google Apps Script con CLASP

Si trabajas con Google Sheets + Apps Script, probablemente editas tu código en el navegador. Funciona… pero no es ideal para developers.

No hay buen control de versiones.
No hay autocompletado potente.
No hay flujo real de desarrollo.

La solución: CLASP.

CLASP te permite trabajar Apps Script desde tu terminal Linux, usando Git y tu editor favorito.

---

Qué es CLASP

CLASP significa:

Command Line Apps Script Projects

Es una herramienta oficial de Google que permite:

• editar Apps Script desde tu computadora
• sincronizar código con Google
• usar Git para versionado
• trabajar con VSCode, Vim, Neovim, etc.

En pocas palabras:
Apps Script como un proyecto real de desarrollo.

---

Requisitos

Antes de empezar necesitas:

node 20

Verifica:

node -v

Luego instala CLASP globalmente:

npm install -g @google/clasp

Prueba que funciona:

clasp

Terminal Linux mostrando CLASP ejecutándose

---

Caso 1 — La hoja ya tiene Apps Script vinculado

Esto pasa cuando el script ya existe en la hoja de cálculo.

Ruta en Google Sheets:

Extensiones → Apps Script

En este caso no debes crear un proyecto nuevo.
Debes conectarte al existente.

---

Paso a paso

1. Abre el editor de Apps Script

En tu hoja de cálculo: Extensiones → Apps Script Se abrirá el editor web.

---

2. Copia el Script ID

En el editor: Project Settings → Script ID Se verá algo así:

1aBcDeFgHiJkLmNoPqRsTuVwXyZ

Ese ID identifica tu proyecto en Google.

---

3. Conecta tu terminal al proyecto

Primero crea una carpeta local:

mkdir pasarela-de-pagos
cd pasarela-de-pagos

Login en Google:

clasp login

Ahora clona el proyecto:

clasp clone TU_SCRIPT_ID

Ejemplo:

clasp clone 1aBcDeFgHiJkLmNoPqRsTuVwXyZ

Esto descargará el código del Apps Script a tu máquina.

---

4. Trabaja como developer real

Ahora puedes usar Git:

git init
git add .
git commit -m "Initial sync"

Subir cambios a Google:

clasp push

Traer cambios del editor web:

clasp pull

---

Ventajas de este flujo

Trabajar Apps Script desde Linux te da:

• control de versiones con Git
• desarrollo más rápido
• editor profesional (VSCode, Neovim)
• respaldo real del código
• posibilidad de integrar CI/CD

---

Conclusión

Si desarrollas con Google Apps Script, trabajar solo en el navegador es limitarte.

CLASP convierte Apps Script en un proyecto real de desarrollo. Terminal. Git. Editor profesional. Mucho más rápido.