Extiende 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 permiten integrar 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 el Google Workspace Marketplace.

Qué puedes hacer

Estas son algunas acciones que puedes realizar con complementos que extienden Hojas de cálculo:

Los complementos de Hojas de cálculo se crean con Apps Script. Para obtener más información sobre cómo acceder a Hojas de cálculo y administrarla con Apps Script, consulta Extiende Hojas de cálculo.

Estructura de la hoja

Una hoja de cálculo de Hojas de cálculo consta de una o más hojas. Cada hoja es esencialmente una cuadrícula 2D de celdas en la que se pueden almacenar texto, números, vínculos u otros valores. 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 los datos y el comportamiento 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 tiene varias funciones integradas , como SUM y AVERAGE, que se pueden invocar desde una celda de Hojas 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, cualquier función personalizada definida que se incluya en el complemento estará disponible de inmediato. Es posible que un complemento conste solo de definiciones de funciones personalizadas. Las definiciones de funciones personalizadas se comparten principalmente con otras personas mediante la publicación de un complemento que contiene las definiciones.

Crea funciones personalizadas de complementos

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

Cuando crees funciones personalizadas en un complemento, debes seguir las pautas generales de las funciones personalizadas:

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

  • Cuando nombres 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 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 precisos de JSDoc 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 para complementos.
  • Las funciones personalizadas que no se completan en menos de 30 segundos fallan y muestran el 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 cuando puedas.
  • Las funciones personalizadas no pueden usar servicios de Apps Script que requieran autorización y fallan con el error You do not have permission to call X service si se intenta. Usa solo los servicios permitidos en tu función personalizada.
  • Cada función personalizada en Hojas de cálculo genera una llamada independiente a los servidores de Apps Script. Si un usuario intenta usar funciones personalizadas en demasiadas celdas, las funciones pueden ejecutarse lentamente. Para mitigar este problema, mantén tus funciones personalizadas lo más sencillas 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 con 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 realizadas en Hojas de cálculo y repetirlas más tarde con una combinación de teclas. Cuando se crea una macro en Hojas de cálculo, se agrega como una función de macro en un proyecto de Apps Script vinculado a esa Hojas de cálculo. Para obtener más información sobre las macros, consulta Macros de Hojas de cálculo.

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, no estará disponible para los usuarios de ese complemento.