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 mejoran el flujo de trabajo de manera personalizada, 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 de las cosas que puede hacer con un complemento que extienda Hojas de cálculo de Google:

• Puedes leer, editar, visualizar y formatear datos en Hojas de cálculo de Google con el servicio de Hojas de cálculo integrado de Apps Script. El servicio también te permite crear y modificar el formato condicional y las reglas de validación de datos.
• Puedes usar el servicio avanzado de Hojas de cálculo de Apps Script para acceder directamente a la API de Hojas de cálculo de Google.
• Puedes crear menús personalizados y definir varias interfaces de cuadros de diálogo personalizados y barras laterales con HTML y CSS estándar.
• Puedes incluir definiciones de función personalizada en tu complemento.
• Puedes usar activadores de complementos que ejecutan funciones específicas cuando se producen ciertos eventos de activación.

Los complementos de Hojas de cálculo se crean con Apps Script. Para obtener más información sobre cómo acceder y administrar las 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. 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 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 específica 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 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 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 adicionales para complementar estas funciones integradas. Cuando un usuario instala el complemento, cualquier función personalizada definida que se incluya con el complemento estará disponible de inmediato. Es posible que un complemento consista solo en definiciones de funciones personalizadas. Las definiciones de las funciones personalizadas se comparten principalmente con otros usuarios 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 complemento 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 a cualquier otra función integrada de Hojas de cálculo: en una celda de Hojas de cálculo, ingresa el = seguido del nombre de la función y cualquier parámetro requerido. Si no hay errores, el resultado que muestra la función se coloca en la celda de Hojas de cálculo, lo que desborda las celdas adyacentes según sea necesario.

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

• Lineamientos para asignar nombres a las funciones
• Define argumentos de funciones
• Definición del valor que se muestra de la función
• Tipos de datos de funciones personalizadas
• Cómo habilitar la función de autocompletar con JSDoc
• Servicios que las funciones personalizadas pueden usar
• Optimiza las funciones personalizadas

Además, las funciones personalizadas que se definen en los complementos tienen algunas consideraciones especiales:

• Cuando asignes un 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 funciones personalizadas con el mismo nombre, los usuarios solo pueden usar una de ellas.
• Tu complemento debe comunicar con claridad las funciones personalizadas que proporciona. Asegúrate de proporcionar comentarios de JSDoc precisos para tus funciones personalizadas, de manera 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 la página web de asistencia de un complemento.
• Las funciones personalizadas que no se completan en menos de 30 segundos generan 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 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 service si esto se intenta. Solo usa los servicios permitidos en tu función personalizada.
• Cada función personalizada de una hoja genera una llamada por separado a los servidores de Apps Script. Si un usuario intenta usar funciones personalizadas en demasiadas celdas, es posible que 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 en la barra lateral.

Macros de Hojas de cálculo

Las macros te permiten registrar acciones tomadas 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 la 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 macrodefinición en el manifiesto de un complemento, no estará disponible para los usuarios de ese complemento.