Google Slides

El componente Google Slides te permite trabajar con presentaciones de Google Slides directamente desde el dashboard de Nappai. Puedes crear nuevas presentaciones, obtener información de páginas, reemplazar texto o imágenes, y mucho más, todo sin salir de la interfaz gráfica.

¿Cómo funciona?

El componente se conecta a la API de Google Slides mediante una credencial que debes configurar previamente en Nappai. Cuando seleccionas una operación, el componente envía la solicitud correspondiente a la API y devuelve los datos o la herramienta que puedes usar en tu flujo de trabajo. Si activas el Mapping Mode, el componente puede procesar varios registros a la vez, lo que facilita la automatización de tareas repetitivas.

Operaciones

Este componente ofrece varias operaciones que puedes seleccionar según lo que necesites hacer. Solo puedes usar una operación a la vez:

Get Page: Obtiene la información de una página específica dentro de una presentación.
Get Thumbnail: Genera una miniatura de una página de la presentación.
Create Presentation: Crea una nueva presentación vacía o a partir de una plantilla.
Get Presentation: Recupera la lista de presentaciones o una presentación específica.
Get Slides: Obtiene todas las diapositivas de una presentación.
Replace Text: Busca y reemplaza texto dentro de la presentación.
Replace Image: Sustituye una imagen por otra usando su ID.

Para usar el componente, primero selecciona la operación que necesitas en el campo Operation (Operación).

Entradas

Modo de Mapeo (Mapping Mode)

Este componente cuenta con un modo especial llamado “Mapping Mode” (Modo de Mapeo). Cuando activas este modo mediante el interruptor, se habilita una entrada adicional llamada Mapping Data y cada campo de entrada te ofrece tres formas diferentes de proporcionar datos:

Fixed (Fijo): Escribes el valor directamente en el campo.
Mapped (Mapeado): Conectas la salida de otro componente para usar su resultado como valor.
Javascript: Escribes código Javascript para calcular el valor dinámicamente.

Esta flexibilidad te permite crear flujos de trabajo más dinámicos y conectados.

Campos de Entrada

Los siguientes campos están disponibles para configurar este componente. Cada campo puede estar visible en diferentes operaciones:

Presentation File: Selecciona una presentación de Google Slides. En la operación Create Presentation, si no se proporciona un ID, se creará una presentación vacía. En Get Presentation, si no se proporciona un ID, se devolverán todas las presentaciones.
- Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image
Operation: Dropdown que indica la operación a ejecutar.
- Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image
Last Url: La última URL utilizada para tu Google Slides.
- Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image
Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.
- Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image
Mode of Input: Modo de uso de los datos de entrada.
- Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image
Object ID to Replace: El ID del objeto que quieres reemplazar en tu Google Slides.
- Visible en: Replace Image
Page Object ID: El ID del objeto de página de tu Google Slides.
- Visible en: Get Page, Get Thumbnail
Presentation ID: El ID de la presentación de Google Slides. En Create Presentation, si no se proporciona, se creará una presentación vacía. En Get Presentation, si no se proporciona, se devolverán todas las presentaciones.
- Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image
Replace Text: El texto que quieres reemplazar en tu Google Slides.
- Visible en: Replace Text
Replace Image URL: La URL de la nueva imagen que reemplazará a la antigua.
- Visible en: Replace Image
Search Text: El texto que buscas en tu Google Slides.
- Visible en: Replace Text
Title Presentation: El título de la presentación. Se usa en Create Presentation y Create Presentation-From-Template.
- Visible en: Create Presentation
Tool Name: El nombre de la herramienta que se mostrará al agente cuando el componente esté conectado como herramienta.
- Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image
Tool Description: Descripción detallada de lo que hace esta herramienta.
- Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image
Tools arguments metadata: Define los metadatos de los argumentos de la herramienta.
- Visible en: Get Page, Get Thumbnail, Create Presentation, Get Presentation, Get Slides, Replace Text, Replace Image

Nota importante: Este componente requiere una credencial de tipo Slides API.

Configura primero la credencial en la sección de credenciales de Nappai.

Luego selecciona esa credencial en el campo Credential del componente.
La credencial se obtiene en la consola de Google Cloud y necesita el Client Id, Client Secret, el acceso a Google Slides y la URL de conexión del servidor de Slides.

Salidas

Data: Devuelve los datos obtenidos o modificados por la operación seleccionada.
Tool: Devuelve una herramienta que puede ser usada por agentes de IA dentro del flujo de trabajo.

Ejemplo de Uso

Supongamos que quieres reemplazar el texto “Informe” por “Reporte” en una presentación existente:

Activa el componente Google Slides.
Selecciona la operación Replace Text.
En Presentation ID escribe el ID de la presentación.
En Search Text escribe “Informe”.
En Replace Text escribe “Reporte”.
Conecta la salida Data a otro componente que necesite la presentación actualizada.

Al ejecutar el flujo, el componente enviará la solicitud a la API de Google Slides y devolverá la presentación con el texto actualizado.

Componentes Relacionados

Google Slides Custom: Versión base que maneja la lógica de conexión a la API.
Google Slides Custom (Mapping): Variante que permite procesamiento por lotes.

Consejos y Mejores Prácticas

Usa el Modo de Mapeo cuando necesites procesar varias presentaciones a la vez; evita ejecutar el componente varias veces.
Guarda el ID de la presentación en una variable para reutilizarlo en operaciones posteriores.
Comprueba los permisos de la credencial; asegúrate de que tenga acceso completo a Google Slides.
Prueba con una presentación de prueba antes de trabajar con datos reales para evitar cambios inesperados.

Consideraciones de Seguridad

La credencial de Slides API contiene información sensible (Client Id y Client Secret). No la compartas públicamente.
Asegúrate de que solo los usuarios autorizados tengan acceso a la sección de credenciales en Nappai.
Revisa los logs de auditoría para detectar accesos no autorizados a la API de Google Slides.