Hojas de cálculo de Google es una herramienta de solución de hojas de cálculo con colaboración en tiempo real y herramientas potentes para visualizar, procesar y comunicar datos.
Puede ampliar Hojas de cálculo con complementos que creen mejoras personalizadas en el flujo de trabajo. integrar sus datos de Hojas de cálculo y establecer una conexión con sistemas de terceros en otras aplicaciones de Google Workspace (como Presentaciones de Google).
Puedes ver los complementos de Hojas de cálculo que otros usuarios crearon Google Workspace Marketplace
Qué puedes hacer
Estas son algunas acciones que puedes realizar con un complemento que extienda Hojas de cálculo de Google:
- Puedes leer, editar, visualizar y dar formato a los datos en las Hojas de cálculo de Google mediante la secuencia de comandos integrada Servicio de hojas de cálculo. El servicio también te permite crear y modificar el formato condicional y los datos las reglas de validación.
- Puedes usar el servicio avanzado de Hojas de cálculo de Apps Script para acceder directamente a la API de Google Sheets.
- Puedes crear menús personalizados y definir varios diálogos y barras laterales personalizados con HTML y CSS estándar.
- Puedes incluir definiciones de funciones personalizadas en tus complemento.
- Puedes usar activadores de complementos que ejecutan funciones especificadas cuando se produzcan ciertos eventos de activación.
Los complementos de Hojas de cálculo se compilan con Apps Script. Para obtener más información sobre cómo acceder y administrar Hojas de cálculo de Google con Apps Script, consulta Extiende Hojas de cálculo de Google.
Estructura de la hoja
Un archivo de Hojas de cálculo de Google consta de una o más hojas. Cada hoja es básicamente una cuadrícula 2D de celdas en la que se puede ingresar texto, números, vínculos u otra cuando se pueden almacenar valores. Un grupo de una o más celdas adyacentes se denomina rango.
El servicio Spreadsheet de Apps Script
proporciona varias clases para representar estructuras organizativas en Hojas de cálculo
(como Sheet y
Range). Puedes usar estas
para leer y modificar datos y comportamiento de Hojas de cálculo.
Activadores
Los activadores de Apps Script permiten que un proyecto de secuencia de comandos ejecutar una función específica cuando se cumplen ciertas condiciones, como cuando una cuando se abre una hoja de cálculo o cuando se instala un complemento.
Consulta Activadores de complementos para obtener más información sobre qué activadores pueden usarse con los complementos de Hojas de cálculo y qué restricciones se aplican a su uso.
Funciones personalizadas
Google Sheets tiene una serie de
funciones integradas
como SUM y AVERAGE, que se pueden invocar desde una celda de Hojas de cálculo de Google.
Los complementos de Hojas de cálculo pueden definir
funciones personalizadas para complementar estas
funciones integradas. Cuando un usuario
instala el complemento y todas las funciones personalizadas definidas que se incluyen con él
estén disponibles de inmediato. Un complemento puede constar de
solo definiciones de funciones personalizadas. Las definiciones de las funciones personalizadas
compartido con otros a través de la publicación de un complemento que contenga las definiciones.
Cómo crear funciones personalizadas de complementos
Cualquier función definida en un proyecto de secuencia de comandos de complemento se puede usar como un
. Una vez que se implemente la función y se instale el complemento,
puedes llamar a la función personalizada como a cualquier otra función integrada de Hojas de cálculo: en un
Celda de la hoja, ingresa el = seguido del nombre de la función y los campos obligatorios
parámetros. Si no hay errores, el resultado que devuelve la función es
colocarse en la celda Hoja, desbordando las celdas vecinas según sea necesario.
Cuando crees funciones personalizadas en un complemento, sigue estos pasos: lineamientos generales sobre las funciones personalizadas:
- Lineamientos para los nombres de funciones
- Cómo definir argumentos de funciones
- Define el valor que se muestra de la función
- Tipos de datos de las funciones personalizadas
- Habilita la función de autocompletar con JSDoc
- Las funciones personalizadas de Services pueden usar
- Optimiza las funciones personalizadas
Además, las funciones personalizadas definidas en los complementos tienen consideraciones:
- Cuando le pongas nombre a tu función, intenta crear un nombre único, quizás relacionado con el nombre de tu complemento. Si dos o más complementos instalados definen una configuración con el mismo nombre, los usuarios solo pueden usar una de ellas.
- Tu complemento debe comunicar claramente qué funciones personalizadas proporciona. Asegúrate de proporcionar comentarios JSDoc precisos para tus funciones personalizadas para que Apps Script puede presentar información de autocompletar para el usuario. Además, considera proporcionar documentación adicional del funciones personalizadas, ya sea en el propio complemento o en una página web de compatibilidad de este.
- Las funciones personalizadas que no se completan en menos de 30 segundos generan un
Internal error executing the custom functionerror. Crea un buen usuario limitando la cantidad de procesamiento que se realiza en una función personalizada. Optimiza la función. siempre que sea posible. - Las funciones personalizadas no pueden usar
servicios de Apps Script que requieran autorización
y fallarán con un error
You do not have permission to call X servicesi este de red. Usa únicamente el servicios permitidos en tu función personalizada. - Cada función personalizada de una hoja da como resultado una llamada independiente a Apps Script servidores. Si un usuario intenta utilizar funciones personalizadas en demasiadas celdas, el pueden ejecutarse lentamente. Para mitigar esto, mantén tus funciones personalizadas sea lo más simple posible. Si necesitas que la función realice tareas complejas no uses una función personalizada, proporciona esa funcionalidad a través de un elemento de menú, un diálogo o una interacción en la barra lateral.
Macros de Hojas de cálculo
Las macros te permiten grabar acciones tomados en Google Sheets y repetirlos más tarde con una combinación de teclas. Cuando un elemento se crea en una hoja, se agrega como una macrofunción en una aplicación El proyecto de secuencia de comandos vinculado a esa hoja. Para ver más más detallada sobre macros, consulta Macros de Hojas de cálculo de Google
Lamentablemente, las macros de Hojas de cálculo no se pueden distribuir con complementos. Si incluyes definición de macro en el manifiesto de un complemento, no estará disponible para los usuarios de ese complemento.