Hojas de cálculo de Google te permite grabar macros que duplican una serie específica de interacciones de la IU que definas. Una vez que hayas grabado una macro, puedes vincularla a una combinación de teclas en el formulario Ctrl+Alt+Shift+Number. Puedes usar ese atajo para ejecutar rápidamente los mismos pasos de la macro, por lo general, en otro lugar o con otros datos. También puedes activar la macro desde el menú Extensiones > Macros de Hojas de cálculo de Google.
Cuando grabas una macro, Hojas de cálculo de Google crea automáticamente una función de Apps Script (la función de macro) que replica los pasos de la macro. La función de macro se agrega a un proyecto de Apps Script vinculado a la hoja, en un archivo titulado macros.gs. En el caso de que ya haya un archivo de proyecto vinculado a la hoja con ese nombre, se le agrega la función de macro. Hojas de cálculo de Google también actualiza automáticamente el manifiesto del proyecto de secuencia de comandos, y registra el nombre y la combinación de teclas asignados a la macro.
Como cada macro grabada se define por completo en Apps Script, puedes editarlas directamente en el editor de Apps Script. Incluso puedes escribir macros desde cero en Apps Script o tomar funciones que ya escribiste y convertirlas en macros.
Cómo crear macros en Apps Script
Puedes tomar funciones escritas en Apps Script y usarlas como funciones de macro. La forma más sencilla de hacerlo es importar una función existente desde el editor de Hojas de cálculo de Google.
Como alternativa, puedes crear macros en el editor de Apps Script siguiendo estos pasos:
- En la IU de Hojas de cálculo de Google, selecciona Extensiones > Apps Script para abrir la secuencia de comandos vinculada a la hoja en el editor de Apps Script.
- Escribe la función de macro. Las funciones de macro no deben tomar argumentos ni mostrar valores.
- Edita el manifiesto de la secuencia de comandos para crear la macro y vincularla a la función de macro. Asigna un nombre y un atajo de teclado únicos.
- Guarda el proyecto de secuencia de comandos. Luego, la macro estará disponible para usarse en la hoja.
- Prueba la función de macro en la hoja para verificar que funcione según lo previsto.
Cómo editar macros
Para editar las macros adjuntas a una hoja, sigue estos pasos:
- En la IU de Hojas de cálculo de Google, selecciona Extensiones > Macros > Administrar macros.
- Busca la macro que deseas editar y selecciona > Editar macro. Se abrirá el editor de Apps Script en el archivo del proyecto que contiene la función de macro.
- Edita la función de la macro para cambiar su comportamiento.
- Guarda el proyecto de secuencia de comandos. Luego, la macro estará disponible para usarse en la hoja.
- Prueba la función de macro en la hoja para verificar que funcione según lo previsto.
Cómo importar funciones como macros
Si ya hay una secuencia de comandos vinculada a una hoja, puedes importar una función en la secuencia de comandos como una macro nueva y, luego, asignarle una combinación de teclas. Para ello, edita el archivo de manifiesto y agrega otro elemento a la propiedad sheets.macros[].
Como alternativa, sigue estos pasos para importar una función como una macro desde la IU de Hojas de cálculo:
- En la IU de Hojas de cálculo de Google, selecciona Extensiones > Macros > Importar.
- Selecciona una función de la lista que se presenta y, luego, haz clic en Agregar función.
- Selecciona para cerrar el diálogo.
- Selecciona Extensiones > Macros > Administrar macros.
- Ubica la función que acabas de importar en la lista. Asigna un atajo de teclado único a la macro. También puedes cambiar el nombre de la macro aquí. De forma predeterminada, el nombre es el de la función.
- Haz clic en Actualizar para guardar la configuración de la macro.
Estructura del manifiesto para macros
En el siguiente fragmento de ejemplo de un archivo de manifiesto, se muestra la sección de un manifiesto que define las macros de Hojas de cálculo de Google. La sección sheets del manifiesto define el nombre y la combinación de teclas asignados a la macro, y el nombre de la función de la macro.
{ ... "sheets": { "macros": [{ "menuName": "QuickRowSum", "functionName": "calculateRowSum", "defaultShortcut": "Ctrl+Alt+Shift+1" }, { "menuName": "Headerfy", "functionName": "updateToHeaderStyle", "defaultShortcut": "Ctrl+Alt+Shift+2" }] } } Consulta el recurso de manifiesto de la macro de Hojas de cálculo para obtener más detalles sobre cómo se construyen los manifiestos de las macros de Hojas de cálculo.
Prácticas recomendadas
Cuando crees o administres macros en Apps Script, te recomendamos que sigas estos lineamientos.
- Las macros tienen mejor rendimiento cuando son ligeras. Cuando sea posible, limita la cantidad de acciones que realiza una macro.
- Las macros son más adecuadas para operaciones rutinarias que deben repetirse con frecuencia con poca o ninguna configuración. Para otras operaciones, considera usar un elemento de menú personalizado.
- Recuerda siempre que las combinaciones de teclas de las macros deben ser únicas y que una hoja determinada solo puede tener diez macros con combinaciones de teclas en un momento dado. Las macros adicionales solo se pueden ejecutar desde el menú Extensiones > Macros.
- Las macros que realizan cambios en una sola celda se pueden aplicar a un rango de celdas. Para ello, primero selecciona el rango completo y, luego, activa la macro. Esto significa que, a menudo, no es necesario crear macros que dupliquen la misma operación en un rango de celdas predefinido.
Qué no puedes hacer
Existen algunas restricciones sobre lo que puedes hacer con las macros:
Usa macros fuera de las secuencias de comandos vinculadas
Las macros se definen en secuencias de comandos vinculadas a Hojas de cálculo de Google específicas. Las definiciones de macros se ignoran si se definen en una secuencia de comandos independiente o una app web.
Cómo definir macros en complementos de Hojas de cálculo
No puedes distribuir definiciones de macros con un complemento de Hojas de cálculo. Los usuarios del complemento ignoran las definiciones de macros en un proyecto de complemento de Hojas de cálculo.
Cómo distribuir macros en bibliotecas de secuencias de comandos
No puedes distribuir definiciones de macros con bibliotecas de Apps Script.
Usa macros fuera de Hojas de cálculo de Google
Las macros son solo una función de Hojas de cálculo de Google y no existen para Documentos, Formularios ni Presentaciones de Google.