Drive File Manager

Drive File Manager conecta tu flujo con tu Google Drive para trabajar con archivos: subir archivos nuevos, consultar los de una carpeta o buscarlos por nombre, leer su contenido, copiarlos, moverlos, cambiarles el nombre, compartirlos y eliminarlos.

Es útil cuando los documentos forman parte de un proceso: informes que el flujo genera y guarda en Drive, contratos que un agente de IA tiene que leer o archivos que hay que compartir con un cliente.

Cuándo usarlo

Un flujo genera un informe en PDF y quieres guardarlo en una carpeta concreta de Drive.
Quieres que un agente de IA lea el texto de los documentos de una carpeta para responder preguntas sobre ellos.
Al cerrar una venta, quieres compartir con el cliente un documento de su proyecto.
Necesitas mover a una carpeta de archivo los documentos ya procesados.
Un agente atiende peticiones de documentos y tiene que poder buscarlos y enviar el enlace.

Configuración

Necesitas una credencial Google Drive, que se conecta iniciando sesión con tu cuenta de Google. Para subir, modificar, compartir o eliminar archivos, la credencial debe tener el acceso Create, Update, Delete, Read; con Read Only solo puedes consultar. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial Google Drive de la cuenta con la que trabajas.
Operation	Lo que hace el componente. Ver Operaciones. Por defecto, `Upload`.
Mode of Input	Cómo indicas el archivo o la carpeta. `By Selection` muestra un selector para elegirlo de tu Drive; `By Id` te pide su identificador; `By Url` te pide su enlace. En `Get` hay además `All Files in Drive` (todos los archivos de tu Drive) y `By Filename` (buscar por nombre). Por defecto, `By Selection`.
Selection Mode	Solo en `Get`. `Folder` devuelve todos los archivos de una carpeta; `File` devuelve un archivo concreto. Por defecto, `Folder`.
Select file / File Id / File Url	El archivo con el que trabajas, según Mode of Input. Obligatorio en todas las operaciones menos `Upload`.
Select folder / Folder Id / Folder Url	La carpeta, según Mode of Input. En `Upload` es la carpeta donde se guarda el archivo (si la dejas vacía, la raíz de tu Drive); en `Move` y `Update`, la carpeta a la que se lleva el archivo; en `Get` con Selection Mode en `Folder`, la carpeta cuyos archivos quieres.
Filename	En `Upload`, el nombre que tendrá el archivo; si lo dejas vacío, se usa el nombre que trae el archivo. En `Get` con `By Filename`, el texto que se busca en el nombre de los archivos.
File Content	Solo en `Upload`. Los archivos que se suben. Conecta aquí un componente que entregue archivos, o un enlace a un archivo. Si conectas varios, se suben todos.
New Name	Solo en `Update`. El nombre nuevo del archivo.

Operaciones

Operación	Qué hace
`Upload`	Sube uno o varios archivos a una carpeta de tu Drive.
`Get`	Devuelve los datos de un archivo, de los archivos de una carpeta, de los que contienen un texto en el nombre o de todo tu Drive. Puede incluir su contenido.
`Copy`	Crea una copia de un archivo, con el mismo nombre que el original.
`Update`	Cambia el nombre de un archivo y, si eliges una carpeta, lo lleva a ella.
`Move`	Lleva un archivo a otra carpeta.
`Share`	Da acceso al archivo a una persona, a un grupo o a cualquiera con el enlace.
`Delete`	Elimina un archivo de forma definitiva, sin pasar por la papelera.

Opciones avanzadas

Campo	Qué hace
File Type Retrieve	Solo en `Get`. Filtra por tipo de archivo: `Any`, `Document`, `Spreadsheet`, `Forms`, `Presentation`, `Pdf`, `Image`, `Video` o `Audio`. Se usa cuando buscas archivos sin elegir uno concreto. Por defecto, `Any`.
Download Base64 Content	Solo en `Get`. Incluye el contenido del archivo, preparado para pasarlo a otro componente que trabaje con archivos. Por defecto, desactivado.
Process File Content	Solo en `Get`. Incluye el texto del archivo, por ejemplo de un PDF, un documento o una hoja de cálculo. Por defecto, desactivado.
Process Images with OCR	Solo en `Get`, cuando Process File Content está activado. Lee también el texto que aparece en las imágenes. Por defecto, desactivado.
Email	Solo en `Share`. El correo de la persona o del grupo con quien compartes. Obligatorio salvo con Type en `anyone`.
Role	Solo en `Share`. El permiso que se da: `reader` (ver), `commenter` (ver y comentar) o `writer` (editar). Por defecto, `reader`.
Type	Solo en `Share`. A quién se da el acceso: `user` (una persona), `group` (un grupo de Google) o `anyone` (cualquiera con el enlace). Por defecto, `user`.
Send Notification	Solo en `Share`. Envía un correo de aviso a la persona con quien compartes. Por defecto, desactivado.

Las opciones de contenido (Download Base64 Content, Process File Content y Process Images with OCR) no aparecen con All Files in Drive.

Resultado

La salida Data devuelve un elemento por cada archivo con el que has trabajado, con su identificador (id), su nombre, su tipo, la carpeta en la que está y el enlace para abrirlo (url). En Get incluye además el contenido o el texto si los has pedido. En Share añade el enlace para compartir (share_url); con Type en anyone, es un enlace de descarga directa. Delete devuelve una confirmación.

Puedes conectar el resultado a un agente de IA para que lea los documentos, a un componente de correo para enviar el enlace o a otro componente que guarde los datos. El componente también se puede conectar a un Agente como herramienta, para que el agente decida cuándo buscar, subir o compartir archivos. Ver Tool Mode.

Ejemplo

Una consultora guarda en Drive el informe mensual de cada cliente y se lo comparte.

El flujo genera el informe en PDF.
Añade Drive File Manager con la operación Upload, conecta el informe a File Content, elige la carpeta Informes en Select folder y escribe en Filename Informe marzo seguido del nombre del cliente.
Añade otro Drive File Manager con la operación Share, Mode of Input en By Id y el id que devuelve el paso anterior en File Id.
En las opciones avanzadas, pon el correo del cliente en Email, deja Role en reader y activa Send Notification para que reciba el aviso de Google.

Buenas prácticas

Delete no se puede deshacer. Si quieres poder recuperar el archivo, muévelo con Move a una carpeta de archivo.
Compartir con anyone deja el archivo accesible a cualquiera que tenga el enlace. Úsalo solo con documentos públicos.
Si buscas con By Filename, se devuelven todos los archivos cuyo nombre contiene el texto. Usa un texto lo bastante concreto o combínalo con File Type Retrieve.

Componentes relacionados

Drive Folder Manager: crear, consultar, compartir y eliminar carpetas.
Google Drive Webhook: iniciar un flujo cuando cambia un archivo.
Drive Search: buscar archivos en Drive.