Amplía Hojas de cálculo de Google con complementos

Hojas de cálculo de Google es una solución de hojas de cálculo basada en la nube con colaboración en tiempo real y herramientas potentes para visualizar, procesar y comunicar datos.

Puedes extender Hojas de cálculo con complementos que crean mejoras personalizadas en el flujo de trabajo, establecen conectividad con sistemas de terceros y, además, integran tus datos de Hojas de cálculo con otras aplicaciones de Google Workspace (como Presentaciones de Google).

Puedes ver los complementos de Hojas de cálculo que crearon otros usuarios en Google Workspace Marketplace.

Qué puedes hacer

Estas son algunas acciones que puedes realizar con un complemento que extiende Hojas de cálculo de Google:

Los complementos de Hojas de cálculo se compilan con Apps Script. Para obtener más información sobre cómo acceder a Hojas de cálculo de Google y administrarlas con Apps Script, consulta Extensión de Hojas de cálculo de Google.

Estructura de la hoja

Una hoja de cálculo 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 las que se pueden almacenar texto, números, vínculos o cualquier otro valor. Un grupo de una o más celdas adyacentes se denomina rango.

El servicio de hojas de cálculo de Apps Script proporciona varias clases para representar estructuras organizativas en Hojas de cálculo (como Sheet y Range). Puedes usar estas clases para leer y modificar el comportamiento y los datos de Hojas de cálculo.

Activadores

Los activadores de Apps Script permiten que un proyecto de secuencia de comandos ejecute una función especificada cuando se cumplen ciertas condiciones, como 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 se pueden usar con los complementos de Hojas de cálculo y qué restricciones se aplican a su uso.

Funciones personalizadas

Hojas de cálculo de Google tiene varias funciones integradas, como SUM y AVERAGE, que se pueden invocar desde una celda de la hoja de cálculo. Los complementos de Hojas de cálculo pueden definir funciones personalizadas adicionales para complementar estas funciones integradas. Cuando un usuario instala el complemento, las funciones personalizadas definidas que se incluyen con el complemento están disponibles de inmediato. Es posible que un complemento solo contenga definiciones de funciones personalizadas. Las definiciones de funciones personalizadas se comparten principalmente con otras personas publicando un complemento que las contenga.

Cómo crear funciones personalizadas de complementos

Cualquier función definida en un proyecto de secuencia de comandos de complemento se puede usar como función personalizada. Una vez que se implementa la función y se instala el complemento, puedes llamar a la función personalizada como a cualquier otra función integrada de Hojas de cálculo: en una celda de la hoja, ingresa = seguido del nombre de la función y los parámetros obligatorios. Si no hay errores, el resultado que muestra la función se coloca en la celda de la hoja y se desborda a las celdas vecinas según sea necesario.

Cuando crees funciones personalizadas en un complemento, debes seguir los lineamientos generales para las funciones personalizadas:

Además, las funciones personalizadas definidas en complementos tienen algunas consideraciones especiales:

  • Cuando le asignes un nombre a tu función, intenta crear uno único, tal vez relacionado con el nombre de tu complemento. Si dos o más complementos instalados definen funciones personalizadas con el mismo nombre, los usuarios solo podrán usar una de ellas.
  • Tu complemento debe comunicar claramente qué funciones personalizadas proporciona. Asegúrate de proporcionar comentarios de JSDoc precisos para tus funciones personalizadas, de modo que Apps Script pueda presentar información de autocompletado al usuario. Además, considera proporcionar documentación adicional de las funciones personalizadas en el complemento o en una página web de asistencia del complemento.
  • Las funciones personalizadas que no se completan en menos de 30 segundos fallan con un error Internal error executing the custom function. Crea una buena experiencia del usuario limitando la cantidad de procesamiento que realizas en una función personalizada. Optimiza la función siempre que puedas.
  • Las funciones personalizadas no pueden usar los servicios de Apps Script que requieren autorización y fallan con un error You do not have permission to call X service si se intenta hacerlo. Solo usa los servicios permitidos en tu función personalizada.
  • Cada función personalizada en una hoja genera una llamada independiente a los servidores de Apps Script. Si un usuario intenta usar funciones personalizadas en demasiadas celdas, es posible que las funciones se ejecuten lentamente. Para mitigar este problema, mantén tus funciones personalizadas lo más simples posible. Si necesitas que la función realice un procesamiento complejo o extendido, no uses una función personalizada. En su lugar, proporciona esa funcionalidad a través de un elemento de menú, un diálogo o una interacción de barra lateral.

Macros de Hojas de cálculo

Las macros te permiten grabar acciones que realizas en Hojas de cálculo de Google y repetirlas más tarde con una combinación de teclas. Cuando se crea una macro en una hoja de cálculo, se agrega como una función de macro en un proyecto de Apps Script vinculado a esa hoja. Para obtener más información sobre las 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 una definición de macro en el manifiesto de un complemento, esta no estará disponible para los usuarios de ese complemento.