Google Drive Folder Manager

Google Drive Folder Manager es un componente que te permite crear, obtener, eliminar y compartir archivos dentro de tu cuenta de Google Drive directamente desde el dashboard de Nappai. Con él puedes automatizar tareas comunes de gestión de archivos sin salir de la plataforma.

¿Cómo funciona?

El componente se conecta a la API de Google Drive mediante una credencial que ya debes haber configurado en Nappai. Cuando seleccionas una operación, el componente envía la solicitud correspondiente a la API:

Create crea un nuevo archivo en la carpeta indicada.
Get recupera la información de un archivo existente.
Delete elimina un archivo.
Share comparte un archivo con otro usuario y le asigna un permiso.

Si activas el Mapping Mode, el componente puede procesar varios registros a la vez. En ese caso, se habilita la entrada “Mapping Data” y cada campo de entrada puede recibir valores de tres maneras: Fixed, Mapped o Javascript. Esto permite que el flujo trabaje con listas de archivos o carpetas sin necesidad de crear bucles manuales.

Operaciones

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

Create: Crea un nuevo archivo en la carpeta seleccionada.
Get: Obtiene la información de un archivo existente.
Delete: Elimina un archivo de Google Drive.
Share: Comparte un archivo con otro usuario y asigna un permiso.

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:

Select folder: Selecciona la carpeta que se usará.
- Visible en: Create, Get, Delete, Share
Operation: Selecciona la operación a realizar.
- Visible en: Create, Get, Delete, Share
Email: Correo electrónico del usuario con quien se compartirá el archivo.
- Visible en: Share
Filename: Nombre que se usará para el archivo.
- Visible en: Create, Get
Folder Id: Id de la carpeta. Si no se proporciona, se usará la carpeta raíz.
- Visible en: Create, Get, Delete, Share
Mapping Mode: Habilita el modo de mapeo para procesar múltiples registros en lote.
- Visible en: Create, Get, Delete, Share
Mode of Input: Modo de uso.
- Visible en: Create, Get, Delete, Share
- Opciones:
  - All folders in Drive: Se usarán todas las carpetas hasta el límite de 100 archivos.
  - By Id: Se usarán los Ids proporcionados.
  - By Filename: Se usarán los nombres de archivo proporcionados.
  - By Selection: Se usarán los archivos seleccionados manualmente.
  - By Url: Se usarán las URLs de los archivos.
Role: Rol que se asignará al usuario al compartir.
- Visible en: Share
Send Notification: Enviar notificación al usuario.
- Visible en: Share
Type: Tipo de permiso que se asignará al usuario.
- Visible en: Share
Tool Name: Nombre de la herramienta que se mostrará al agente cuando se conecte como herramienta.
- Visible en: Create, Get, Delete, Share
Tool Description: Descripción detallada de lo que hace esta herramienta.
- Visible en: Create, Get, Delete, Share
Tools arguments metadata: Define la metadata de los argumentos de la herramienta.
- Visible en: Create, Get, Delete, Share

Credencial
Este componente requiere una credencial de tipo Google Drive.

Configura primero la credencial “Google Drive” en la sección de credenciales de Nappai.

Luego selecciona esa credencial en el campo “Credential” del componente.
La credencial se obtiene desde la consola de Google Cloud y necesita el Client Id, Client Secret y el acceso a Google Drive.

Salidas

Data: Resultado de la operación (por ejemplo, metadatos del archivo).
Tool: Objeto que permite que un agente de IA utilice esta operación como una herramienta.

Ejemplo de Uso

Crear un archivo
- Selecciona la operación Create.
- En “Select folder” elige la carpeta donde quieres crear el archivo.
- En “Filename” escribe el nombre del archivo.
- (Opcional) Activa “Mapping Mode” y provee una lista de nombres en “Mapping Data” para crear varios archivos a la vez.
- Ejecuta el flujo y el componente devolverá los metadatos del archivo creado en la salida Data.
Compartir un archivo
- Selecciona la operación Share.
- En “Select folder” elige la carpeta que contiene el archivo.
- En “Filename” escribe el nombre del archivo a compartir.
- En “Email” escribe el correo del usuario.
- En “Role” y “Type” selecciona el permiso que deseas otorgar.
- (Opcional) Marca “Send Notification” para enviar una notificación al usuario.
- Ejecuta el flujo y el componente devolverá la confirmación de la operación en la salida Data.

Componentes Relacionados

Google Drive File Component – Gestiona archivos individuales en Google Drive.
Google Drive Folder Component – Crea y administra carpetas en Google Drive.
Google Drive Permission Component – Modifica permisos de archivos y carpetas.

Consejos y Mejores Prácticas

Usa Mapping Mode cuando necesites procesar listas de archivos; evita bucles manuales.
Limita el número de archivos a 100 cuando uses “All folders in Drive” para evitar tiempos de espera largos.
Configura la credencial de Google Drive una sola vez y reutilízala en todos los componentes que la necesiten.
Cuando compartas archivos, revisa el permiso “Type” para asegurarte de que el usuario obtenga el acceso correcto (lectura, edición, etc.).

Consideraciones de Seguridad

La credencial de Google Drive contiene información sensible (Client Id y Client Secret). Guárdala en un lugar seguro y no la compartas.
Los permisos de compartición deben asignarse con cuidado; evita dar permisos de edición a usuarios que no los necesiten.
Si usas “Send Notification”, verifica que el correo del destinatario sea correcto para evitar envíos no deseados.