Proyectos de secuencias de comandos

Un proyecto de secuencia de comandos representa una colección de archivos y recursos de Google Apps Script, a veces denominado simplemente "una secuencia de comandos". Un proyecto de secuencia de comandos tiene uno o más archivos de secuencias de comandos, que pueden ser archivos de código (que tienen una extensión .gs) o archivos HTML (una extensión .html). También puedes incluir JavaScript y CSS en los archivos HTML.

El editor de secuencias de comandos siempre tiene un único proyecto abierto a la vez. Puedes abrir varios proyectos en varias ventanas o pestañas del navegador.

Crea y borra proyectos

En esta sección, se explica cómo crear y borrar proyectos de Apps Script independientes o vinculados a contenedores.

Cómo crear un proyecto independiente

Para crear un proyecto independiente desde Apps Script, sigue estos pasos:

  1. Ve a script.google.com.
  2. Haz clic en New Project.
  3. En el editor de secuencia de comandos, haz clic en Proyecto sin título.
  4. Asígnale un nombre a tu proyecto y haz clic en Cambiar nombre.

Crea un proyecto independiente desde Google Drive

  1. Abre Google Drive.
  2. Haz clic en Nuevo > Más > Google Apps Script.

Crea un proyecto vinculado a contenedores desde Documentos, Hojas de cálculo o Presentaciones de Google

  1. Abre un archivo de Documentos, Hojas de cálculo o Presentaciones.
  2. Haz clic en Extensiones > Google Apps Script.
  3. En el editor de secuencia de comandos, haz clic en Proyecto sin título.
  4. Asígnale un nombre a tu proyecto y haz clic en Cambiar nombre.

Crea un proyecto vinculado a contenedores desde Formularios de Google

  1. Abre un formulario en Formularios de Google.
  2. Haz clic en Más > Editor de secuencias de comandos.
  3. En el editor de secuencia de comandos, haz clic en Proyecto sin título.
  4. Asígnale un nombre a tu proyecto y haz clic en Cambiar nombre.

Crea un proyecto independiente con la herramienta de línea de comandos de clasp

clasp es una herramienta de línea de comandos que te permite crear, extraer, enviar e implementar proyectos de Apps Script desde una terminal.

Consulta la guía Interfaz de línea de comandos con clasp para obtener más detalles.

Borra un proyecto vinculado al contenedor

  1. Abre tu proyecto vinculado a contenedores con el método apropiado que se indicó más arriba.
  2. En la parte superior izquierda, haz clic en Overview .
  3. En la esquina superior derecha, haz clic en Quitar > Borrar definitivamente.

Borra un proyecto independiente

  1. Ve a script.google.com.
  2. A la derecha del proyecto que deseas borrar, haz clic en Más > Quitar > Quitar.

Cómo administrar archivos de un proyecto

Crear un archivo

  1. Abre tu proyecto de Apps Script.
  2. A la izquierda, haz clic en Editor > Add .
  3. Selecciona el tipo de archivo que quieres crear y asígnale un nombre.

Cómo borrar un archivo

  1. Abre tu proyecto de Apps Script.
  2. A la izquierda, haz clic en Editor .
  3. Junto al archivo que deseas borrar, haz clic en Más > Borrar.

Exporta archivos de un proyecto de Apps Script

Para quitar archivos de código de Apps Script, puedes copiar y pegar el código de cada archivo en tu editor de texto preferido o usar clasp en la línea de comandos. Para usar clasp, consulta cómo descargar un proyecto de secuencia de comandos.

Configura la zona horaria de un proyecto

Puedes configurar la zona horaria de un proyecto de Apps Script. Las funciones que realiza la secuencia de comandos usan esta zona horaria.

  1. Abre tu proyecto de Apps Script.
  2. A la izquierda, haz clic en Configuración del proyecto El ícono de la configuración del proyecto.
  3. En la sección Zona horaria, selecciona la zona horaria que quieres usar.

Si deseas que una función específica use una zona horaria diferente a la del proyecto de la secuencia de comandos, ingresa de forma explícita la zona horaria en la función. En el siguiente ejemplo, cada función crea un evento nuevo en el Calendario de Google. La primera función se establece de forma predeterminada en la zona horaria del proyecto. La segunda función especifica la zona horaria del Pacífico, por lo que el evento se programa en hora del Pacífico, independientemente de la zona horaria del proyecto.

function createEvent(){
// Creates an event in the script project's time zone and logs the ID
var event = CalendarApp.getDefaultCalendar().createEvent('New test event',
   new Date('December 20, 2022 17:00:00'),
   new Date('December 20, 2022 18:00:00'));
console.log('Event ID: ' + event.getId());
}
function createEventPacific(){
// Creates an event with a specified time zone and logs the event ID.
var event = CalendarApp.getDefaultCalendar().createEvent('New sample event',
   new Date('December 20, 2022 17:00:00 PDT'),
   new Date('December 20, 2022 18:00:00 PDT'));
console.log('Event ID: ' + event.getId());
}

Cómo solucionar problemas con varias Cuentas de Google

Si accediste a varias Cuentas de Google al mismo tiempo, es posible que tengas problemas para acceder a tus complementos y aplicaciones web. El acceso múltiple o a varias Cuentas de Google a la vez no son compatibles con Apps Script, los complementos ni las apps web.

  • Si abres el editor de Apps Script después de acceder a más de una cuenta, Google te pedirá que elijas la cuenta con la que deseas continuar.

  • Si abres una aplicación web o un complemento y tienes problemas de acceso múltiple, prueba una de las siguientes soluciones:

    • Sal de todas tus Cuentas de Google y accede solo a la que tiene el complemento o la app web a la que deseas acceder.
    • Abre una ventana de incógnito en Google Chrome o una ventana de navegación privada equivalente y accede a la Cuenta de Google que tiene el complemento o la app web a la que deseas acceder.