Se usó la API de Cloud Translation para traducir esta página.

Use la interfaz de línea de comandos con clasp

Para desarrollar y administrar proyectos de Apps Script desde tu terminal en lugar del editor de Apps Script, puedes usar una herramienta de código abierto llamada clasp.

El codelab de clasp proporciona una descripción general de todas las funciones de clasp.

Funciones

Desarrollo local

clasp te permite desarrollar tus proyectos de Apps Script de forma local. Puedes escribir código en tu propia computadora y subirlo a Apps Script cuando termines. También puedes descargar proyectos existentes de Apps Script para poder editarlos cuando estés sin conexión. Como el código es local, puedes usar tus herramientas de desarrollo favoritas, como git, cuando compiles proyectos de Apps Script.

Administrar versiones de implementación

Crea, actualiza y visualiza varias implementaciones de tu proyecto.

Código de estructura

clasp te permite organizar el código en directorios, que se conservan cuando los subes a script.google.com. Por ejemplo:

# On script.google.com:
├── tests/slides.gs
└── tests/sheets.gs

# Locally:
├── tests/
│   ├─ slides.gs
│   └─ sheets.gs

Requisitos

clasp se escribe en Node.js y se distribuye a través de la herramienta npm. Antes de usar clasp, debes tener instalada Node.js 4.7.4 o versiones posteriores. La instalación de Node.js requiere privilegios de administrador.

Instalación

Una vez que instales Node.js, puedes usar el siguiente comando npm para instalar clasp:

npm install @google/clasp -g

Después de la instalación, puedes usar el comando clasp desde cualquier directorio de tu computadora.

Usa `clasp`

Puedes usar clasp para controlar una variedad de tareas desde la línea de comandos. En esta sección, se describen las operaciones comunes que puedes usar cuando desarrollas con clasp.

Este comando permite acceder a los proyectos de Apps Script de tu Cuenta de Google y autorizar su administración. Una vez que se ejecute, se te pedirá que accedas a una Cuenta de Google en la que se almacenen tus proyectos de Apps Script.

clasp login

Salir

Con este comando, se sale de la herramienta de línea de comandos. Debes volver a acceder con clasp login para volver a autenticarte con Google antes de seguir usando clasp.

clasp logout

Crea un nuevo proyecto de Apps Script

Con este comando, se crea una secuencia de comandos nueva en el directorio actual con un título de secuencia de comandos opcional.

clasp create [scriptTitle]

Este comando también crea dos archivos en el directorio actual:

Un archivo .clasp.json que almacene el ID de la secuencia de comandos
Un archivo de manifiesto del proyecto appsscript.json que contiene metadatos del proyecto.

Clone un proyecto existente

Con este comando, se clona un proyecto existente en el directorio actual. Debes crear o compartir la secuencia de comandos con tu Cuenta de Google. Para especificar el proyecto de secuencia de comandos que se clonará, proporciona su ID de secuencia de comandos.

Para encontrar el ID de la secuencia de comandos del proyecto, sigue estos pasos:

Abre el proyecto de Apps Script.
A la izquierda, haz clic en Configuración del proyecto .
En IDs (IDs), copia el ID de la secuencia de comandos.
```
 clasp clone <scriptId>
```

Cómo descargar un proyecto de secuencia de comandos

Este comando descarga el proyecto de Apps Script de Google Drive al sistema de archivos de tu computadora.

clasp pull

Subir un proyecto de secuencia de comandos

Este comando sube todos los archivos del proyecto de una secuencia de comandos de tu computadora a Google Drive.

clasp push

Mostrar lista de versiones de proyectos

Con este comando, se muestra la cantidad y la descripción de cada una de las versiones de un proyecto de secuencia de comandos.

clasp versions

Implementa un proyecto publicado

Puedes implementar proyectos de secuencias de comandos como apps web, complementos o ejecutables. Puedes crear implementaciones en el editor de secuencia de comandos, en el manifiesto del proyecto o con clasp.

Para implementar un proyecto con clasp, primero crea una versión inmutable del proyecto de Apps Script. Una versión es una "instantánea" de un proyecto de secuencia de comandos y es similar a una versión con ramas de solo lectura.

clasp version [description]

Este comando muestra el número de versión recién creado. Con esa cantidad, puedes implementar y anular la implementación de instancias de tu proyecto:

clasp deploy [version] [description]
clasp undeploy <deploymentId>

Este comando actualiza una implementación existente con una versión y una descripción nuevas:

clasp redeploy <deploymentId> <version> <description>

Mostrar lista de implementaciones

Con este comando, se enumeran los ID de implementación del proyecto de la secuencia de comandos, las versiones y sus descripciones.

clasp deployments

Abre el proyecto en el editor de Apps Script

Este comando abre un proyecto de secuencia de comandos en el editor de Apps Script. El editor se inicia como una pestaña nueva en el navegador web predeterminado.

clasp open

Contribuye al proyecto de código abierto `clasp`

Contribuye con clasp en GitHub.