Extiende Hojas de cálculo de Google con complementos

Hojas de cálculo de Google es una solución de hoja 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 compilen mejoras personalizadas del flujo de trabajo, integren los datos de Hojas de cálculo con otras aplicaciones de Google Workspace (como Presentaciones de Google) y establezcan la conectividad con sistemas de terceros.

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

Qué puedes hacer

Estas son algunas de las acciones que puede 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

Un archivo de Hojas de cálculo de Google consta de una o más hojas. En esencia, cada hoja es una cuadrícula de celdas en 2D en la que se pueden almacenar texto, números, vínculos y otros valores. Un grupo de una o más celdas adyacentes se denomina rango.

El servicio de hoja 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 datos y comportamientos de Hojas de cálculo.

Activadores

Los activadores de Apps Script permiten que un proyecto de secuencia de comandos ejecute una función específica cuando se cumplen ciertas condiciones, como cuando se abre una hoja de cálculo o 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 Hojas de cálculo de Google. 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 que se incluyen en él están disponibles de inmediato. Es posible que un complemento incluya solo definiciones de funciones personalizadas. Las definiciones de las funciones personalizadas se comparten principalmente con otras personas mediante la publicación de un complemento que las contiene.

Cómo crear funciones personalizadas de complementos

Cualquier función definida en un proyecto de secuencia de comandos de complemento se puede usar como una función personalizada. Una vez que se implemente la función y el complemento esté instalado, 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 obligatorios. Si no hay errores, el resultado que muestra la función se coloca en la celda de la Hoja de cálculo, que se desborda hasta las celdas vecinas según sea necesario.

Cuando creas funciones personalizadas en un complemento, debes seguir los lineamientos generales de las funciones personalizadas:

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

  • Cuando asignes un nombre a tu función, intenta crear un nombre ú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 pueden usar uno de ellos.
  • El complemento debe comunicar con claridad las funciones personalizadas que 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, procura proporcionar documentación adicional de las funciones personalizadas, ya sea en el complemento o en una página web de compatibilidad con el complemento.
  • Las funciones personalizadas que no se completan en menos de 30 segundos fallan con un error Internal error executing the custom function. Para crear una buena experiencia del usuario, limita 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 generan un error You do not have permission to call X service si se intenta intentarlo. Usa solo los servicios permitidos en tu función personalizada.
  • Cada función personalizada de una hoja de cálculo genera una llamada separada a los servidores de Apps Script. Si un usuario intenta usar funciones personalizadas en demasiadas celdas, es posible que estas se ejecuten con lentitud. Para mitigar este problema, mantén las 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 cambio, proporciona esa funcionalidad a través de un elemento de menú, un diálogo o una interacción con la barra lateral.

Macros de Hojas de cálculo

Las macros te permiten grabar acciones realizadas 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, 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.