Amplía 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 ampliar Hojas de cálculo con complementos que crean mejoras personalizadas del 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 otros crearon en Google Workspace Marketplace.

Qué puedes hacer

Estas son algunas de las 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 Cómo extender 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, en esencia, una cuadrícula 2D de celdas 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 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 se instala un complemento.

Consulta los activadores de complementos para obtener más información sobre los activadores que se pueden usar con los complementos de Hojas de cálculo y las restricciones que 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 definidas que se incluyen con él están disponibles de inmediato. Es posible que un complemento consista solo en definiciones de funciones personalizadas. Las definiciones de funciones personalizadas se comparten principalmente con otras personas mediante la publicación de un complemento que las contiene.

Crea funciones personalizadas del complemento

Cualquier función definida en un proyecto de secuencia de comandos de complemento se puede usar como función personalizada. Una vez que se implemente la función y se instale el complemento, podrás 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 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 los complementos tienen algunas consideraciones especiales:

  • Cuando asignes un nombre a tu función, intenta crear uno ú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 pueden usar una de ellas.
  • El complemento debe comunicar claramente qué funciones personalizadas proporciona. Asegúrate de proporcionar comentarios 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, ya sea 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. Limita la cantidad de procesamiento que realizas en una función personalizada para crear una buena experiencia del usuario. Optimiza la función cuando sea posible.
  • Las funciones personalizadas no pueden usar servicios de Apps Script que requieran autorización y fallan con un error You do not have permission to call X service si se intenta hacerlo. Usa solo 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 con lentitud. Para mitigar esto, 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 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 adelante 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, no estará disponible para los usuarios de ese complemento.