Use la interfaz de línea de comandos con clasp

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

En el codelab de clasp, se proporciona una descripción general de todas las funciones de clasp.

Funciones

Desarrollo a nivel local

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

Administra las versiones de implementación

Crea, actualiza y visualiza tus múltiples implementaciones del proyecto.

Código de la estructura

clasp te permite organizar tu código en directorios, que se conservan cuando los suba 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 Node.js 4.7.4 o una versión posterior instalada La instalación de Node.js requiere privilegios de administrador.

Instalación

Una vez que instales Node.js, puedes usar el siguiente comando de npm para instala 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 varias tareas desde la línea de comandos. Esta En esta sección, se describen las operaciones comunes que puedes usar cuando desarrollas con clasp.

Acceder

Este comando accede y autoriza la administración de las contraseñas de los Proyectos de Apps Script. Una vez ejecutada, se te pide que accedas a una cuenta de Google en la que se almacenan tus proyectos de Apps Script.

clasp login

Cerrar sesión

Este comando 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

Este comando crea una nueva secuencia de comandos en el directorio actual con una secuencia título de la secuencia de comandos.

clasp create [scriptTitle]

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

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

Clone un proyecto existente

Este comando clona un proyecto existente en el directorio actual. El guion deben crearse o compartirse con tu Cuenta de Google. Para especificar el proyecto de secuencia de comandos que quieres clonar, proporciona su ID.

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

  1. Abre el proyecto de Apps Script.
  2. A la izquierda, haz clic en Configuración del proyecto .
  3. En IDs, copia el ID de la secuencia de comandos.

     clasp clone <scriptId>
    

Descarga un proyecto de secuencia de comandos

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

clasp pull

Subir un proyecto de secuencia de comandos

Este comando sube todos los archivos de un proyecto de secuencia de comandos de tu computadora a Google Drive

clasp push

Mostrar lista de versiones del proyecto

Este comando enumera el número y la descripción de cada uno de los versiones.

clasp versions

Implementa un proyecto publicado

Puedes implementar proyectos de secuencias de comandos como aplicaciones web, complementos o ejecutables. Puedes crear deployments 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 script y es similar a una versión ramificada de solo lectura.

clasp version [description]

Este comando muestra el número de versión recién creado. Con ese número, 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

Este comando enumera los IDs de implementación del proyecto de 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 es como una pestaña nueva en tu navegador web predeterminado.

clasp open

Contribuye al proyecto de código abierto clasp

Contribuye con clasp en GitHub.