Si una secuencia de comandos está vinculada a un archivo de Hojas de cálculo, Documentos, Presentaciones o Formularios de Google creada a partir de ese documento, en lugar de 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, con la excepción de que no aparecen en Google Drive, no se pueden separar del archivo a los que están vinculados y obtienen algunos privilegios especiales sobre el archivo principal.
Tenga en cuenta que las secuencias de comandos también pueden vincularse a Google Sites, pero estas casi siempre se implementan como apps web. Secuencias de comandos vinculadas a Hojas de cálculo, Documentos, Presentaciones o Formularios de Google también pueden convertirse en aplicaciones web, aunque esto es poco común.
Crea una secuencia de comandos vinculada
Documentos, Hojas de cálculo o Presentaciones de Google
Para crear una secuencia de comandos vinculada en Documentos, Hojas de cálculo o Presentaciones de Google, abre un documento en Documentos, una hoja de cálculo en Hojas de cálculo o una presentación en Presentaciones y haz clic en Extensiones > Apps Script. Para volver a abrir la secuencia de comandos en hacer lo mismo o abrir el guion desde 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 . > Guion Google Cloud. Para volver a abrir la secuencia de comandos, futuro, haz lo mismo o abre el script desde 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:
getActiveSpreadsheet(),getActiveDocument(),getActivePresentation(), ygetActiveForm()permite que las secuencias de comandos vinculadas hagan referencia a su archivo superior sin hacer referencia al el ID del archivo.getUipermite Las secuencias de comandos vinculadas acceden a la interfaz de usuario de su archivo superior para agregarlas menús, diálogos y barras laterales personalizados.- En Hojas de cálculo de Google,
getActiveSheet(),getActiveRange(), ygetActiveCell()permitir que la secuencia de comandos determine la hoja actual del usuario, el rango de celdas seleccionado o una celda individual seleccionada.setActiveSheet(sheet)ysetActiveRange(range)y dejar que la secuencia de comandos cambie esas selecciones. - En Documentos de Google,
getCursor()ygetSelection()permite que la secuencia de comandos determine la posición del cursor del usuario o del texto seleccionado.setCursor(position)ysetSelection(range)y permitir que la secuencia de comandos cambie esas ubicaciones.
Para obtener más información, consulta la guía para extender Hojas de cálculo de Google la guía para ampliar 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 agregando menús personalizados cuadros de diálogo o barras laterales. Ten en cuenta que sin embargo, una secuencia de comandos solo puede interactuar con la interfaz de usuario del 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 un límite o independiente y deseas compartirlo con el mundo, Apps Script te permite publicar tu secuencia de comandos para que otros usuarios puedan instalarlo desde la tienda del complemento.
Activadores
Las secuencias de comandos vinculadas pueden usar activadores simples
como la función especial onOpen(), que se ejecuta automáticamente cada vez que se carga
Lo abre un usuario con acceso de edición. Al igual que todos los tipos de secuencias de comandos, pueden
También puedes usar activadores instalables.
Funciones personalizadas
Una función personalizada es una función que está en un
de Terraform vinculada a Hojas de cálculo de Google a la que puedes llamar directamente desde una celda usando el
la sintaxis =myFunctionName(). Así, las funciones personalizadas
son similares a los cientos de
funciones integradas en Hojas de cálculo
como AVERAGE o
SUM, excepto que tú definas
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 la secuencia de comandos. pero si hacen una copia del archivo contenedor, se convierten propietario de la copia y puede ver y ejecutar una copia de la secuencia de comandos.
Para obtener información sobre cómo compartir un archivo contenedor de una secuencia de comandos, consulta Cómo compartir archivos de Google Drive