Secuencias de comandos vinculadas a contenedores

Una secuencia de comandos está vinculada a un archivo de Hojas de cálculo, Documentos, Presentaciones o Formularios de Google si se creó a partir de ese documento y no como una secuencia de comandos independiente. El archivo al que se adjunta una secuencia de comandos vinculada se denomina &contenedor; Por lo general, las secuencias de comandos vinculadas se comportan como secuencias de comandos independientes, excepto que no aparecen en Google Drive, no se pueden separar del archivo al que están vinculadas y obtienen algunos privilegios especiales sobre el archivo superior.

Ten en cuenta que las secuencias de comandos también se pueden vincular a Google Sites, pero estas casi siempre se implementan como apps web. Las secuencias de comandos vinculadas a Hojas de cálculo, Documentos, Presentaciones o Formularios también pueden convertirse en aplicaciones web, aunque es poco común.

Crear una secuencia de comandos vinculada

Hojas de cálculo o Documentos de Google

Para crear una secuencia de comandos vinculada en Hojas de cálculo de Google o Documentos, abre un documento o una hoja de cálculo en Hojas de cálculo y haz clic en Extensiones > Apps Script. Para volver a abrir la secuencia de comandos en el futuro, haz lo mismo o ábrela desde el panel de Apps Script.

Presentaciones de Google

Para crear una secuencia de comandos vinculada en Presentaciones de Google, abre un archivo de Presentaciones y haz clic en Herramientas > Editor de secuencias de comandos. Para volver a abrir la secuencia de comandos en el futuro, haz lo mismo o ábrela desde el panel de Apps Script.

Formularios de Google

Para crear una secuencia de comandos vinculada en Formularios de Google, abre un formulario y haz clic en Más > Editor de secuencias de comandos. Para volver a abrir la secuencia de comandos en el futuro, haz lo mismo o ábrela desde el panel de Apps Script.

Métodos especiales

Las secuencias de comandos vinculadas pueden llamar a algunos métodos que las secuencias de comandos independientes no pueden realizar:

Si deseas obtener más información, consulta la guía para extender Hojas de cálculo de Google o la guía para extender Documentos de Google.

Menús, diálogos y barras laterales personalizados

Las secuencias de comandos vinculadas pueden personalizar Hojas de cálculo, Documentos y Formularios de Google mediante la incorporación de menús personalizados y cuadros de diálogo o barras laterales. Sin embargo, ten en cuenta que una secuencia de comandos solo puede interactuar con la interfaz de usuario de la instancia actual de un archivo abierto. Es decir, una secuencia de comandos vinculada a un documento no puede afectar la interfaz de usuario de otro documento.

Complementos

Los complementos se ejecutan en Gmail, Hojas de cálculo de Google, Documentos, Presentaciones y Formularios. Si desarrollaste una secuencia de comandos vinculada o independiente y deseas compartirla con el mundo, Apps Script te permite publicarla como un complemento a fin de que otros usuarios puedan instalarla desde la tienda de complementos.

Activadores

Las secuencias de comandos vinculadas pueden usar activadores simples, como la función especial onOpen(), que se ejecuta de manera automática cada vez que un usuario tiene acceso de edición. Como todos los tipos de secuencias de comandos, también pueden usar activadores instalables.

Funciones personalizadas

Una función personalizada es una función en una secuencia de comandos vinculada a Hojas de cálculo de Google que llamas directamente desde una celda mediante la sintaxis =myFunctionName(). Por lo tanto, las funciones personalizadas son similares a los cientos de funciones integradas de Hojas de cálculo como AVERAGE o SUM, excepto que defines el comportamiento de la función personalizada.

Acceso a secuencias de comandos vinculadas

Solo los usuarios que tienen permiso para editar un contenedor pueden ejecutar su secuencia de comandos vinculada. Los colaboradores que solo tienen acceso de lectura no pueden abrir el editor de secuencias de comandos, aunque si crean una copia del archivo superior, se convierten en propietarios de la copia y podrán ver y ejecutar una copia de la secuencia de comandos.