Guía Completa de Google Apps Script y Workspace Studio

Workspace Studio permite crear flujos que conectan Gmail, Drive, Sheets y otros servicios de Google sin empezar a programar. Pero puede que necesites una operación que no aparezca entre sus pasos: comprobar un dato con tus propias reglas, consultar un sistema interno o devolver un resultado que utilizarán los siguientes pasos del flujo.

Para incorporar esa lógica puedes utilizar Google Apps Script. La clave está en cómo se conecta: no basta con escribir una función y buscarla por su nombre en Workspace Studio. Debes crear un complemento de Google Workspace con un paso personalizado, instalarlo y añadir ese paso al flujo. Es una función pensada para usuarios con conocimientos de desarrollo y su disponibilidad puede depender del acceso concedido a tu organización.

Qué es un paso personalizado de Workspace Studio

Un flujo de Workspace Studio empieza con un activador y continúa con uno o varios pasos. El activador determina cuándo se ejecuta; cada paso realiza una tarea. Un paso personalizado te permite añadir a esa secuencia una operación programada con Apps Script que no esté incluida entre las acciones habituales de Studio.

Por ejemplo, un flujo podría recibir información de un formulario, enviarla a tu paso personalizado para clasificarla según unas reglas y utilizar el resultado para escoger qué hacer después. El script recibe datos de entrada y puede devolver variables de salida para los pasos posteriores. Google también permite crear activadores personalizados, pero son una pieza distinta: sirven para iniciar el flujo desde un evento externo.

Antes de empezar, comprueba que tu cuenta tiene acceso a Workspace Studio y que tu administrador permite utilizar complementos y pasos personalizados. La documentación para desarrolladores de esta integración sigue marcada como vista previa limitada; por eso, una opción que aparece en una guía puede no estar habilitada en todos los dominios.

Cómo preparar la función en Apps Script

La forma más clara de aprender el proceso es partir del ejemplo oficial de Google para crear un paso de calculadora. Su función es sencilla: recibe dos números y una operación, calcula el resultado y lo entrega al flujo. Puedes copiar ese proyecto para ver cómo se relacionan el código y la configuración del complemento antes de adaptarlo a tu caso.

En el archivo appsscript.json se declara el paso mediante workflowAction. Allí se indican sus entradas y salidas y se enlazan las funciones que lo configuran y ejecutan: onConfigFunction prepara las opciones que verá el usuario al añadirlo al flujo, mientras que onExecuteFunction contiene la lógica que se ejecutará cuando el flujo llegue a ese paso.

Por tanto, si ya tienes una función de Apps Script que procesa datos, el trabajo consiste en adaptarla a la estructura de un complemento. Define qué información necesita recibir, cómo se mostrará su configuración y qué devolverá. Una función personalizada escrita para una celda de Google Sheets o un disparador onOpen() no aparecerá automáticamente como paso en Studio.

Instalar el complemento y añadirlo al flujo

Cuando el proyecto esté preparado, abre Apps Script y utiliza Implementar > Probar implementaciones para instalar una versión de prueba del complemento. Autoriza los permisos que necesite. Después entra en Workspace Studio, crea un flujo con un activador fácil de comprobar y pulsa Añadir paso. El paso debería aparecer bajo el nombre del complemento instalado; si no lo ves de inmediato, actualiza el editor.

Configura las entradas del paso y añade una acción posterior que utilice su resultado. Por ejemplo, puedes enviar una notificación a Google Chat con la variable que devuelve el script. Activa el flujo, provoca el evento que lo inicia y revisa Actividad para confirmar que el paso se ejecutó y entregó el dato esperado.

Si el complemento pertenece a otro desarrollador de tu organización, este puede proporcionarte un ID de implementación de prueba para instalarlo como complemento de desarrollador. También existen complementos publicados en Google Workspace Marketplace, sujetos a los permisos y controles establecidos para tu cuenta.

Cuándo tiene sentido añadir Gemini

Un paso personalizado no necesita inteligencia artificial para funcionar. Puede validar un identificador, transformar texto o consultar otro servicio con reglas completamente predecibles. Si el caso requiere resumir o clasificar contenido mediante Gemini, puedes estudiar cómo incorporar esa llamada al código del complemento y devolver una respuesta que el resto del flujo pueda utilizar.

Conviene mantener claras las responsabilidades: el flujo decide cuándo se ejecuta el paso, Apps Script implementa la operación y Gemini solo interviene si lo has integrado expresamente. Para acciones que afectan a correos, calendarios o archivos compartidos, prueba primero con datos de ejemplo y revisa qué permisos se conceden al complemento.

Límites y problemas que debes revisar

Apps Script tiene cuotas de uso y límites de ejecución. Además, la documentación de Google establece un tiempo máximo de dos minutos para los complementos que amplían Workspace Studio dentro de su programa de acceso correspondiente. Por eso, una función que recorre miles de archivos o espera durante mucho tiempo la respuesta de otra API puede no encajar bien como paso de un flujo.

Si el paso no aparece, comprueba la disponibilidad de la función en tu cuenta, la instalación de prueba, los permisos del complemento y los ajustes del administrador. Si aparece pero falla al ejecutarse, revisa la pestaña Actividad del flujo y los registros de Apps Script. También debes confirmar que las variables de entrada tienen el formato que espera tu función y que la salida coincide con lo declarado en el manifiesto.

Añadir Apps Script a Workspace Studio permite llevar una lógica propia a los flujos, pero requiere preparar un complemento, definir su paso y probarlo. Empieza con el ejemplo oficial, consigue que una operación pequeña devuelva una variable y amplía el código cuando ya hayas comprobado que la integración funciona en tu organización.