Google Drive — List files

Tipo: googledrive-list · Paquete: Google Drive v1.0.5 · Salida: List<Dictionary<string,object>>

Lista el contenido de una carpeta o busca archivos y carpetas en todo Drive. Es la forma habitual de obtener los IDs que necesitan el resto de actividades (descargar, mover, compartir…), y de procesar en bloque lo que llega a una carpeta.

Cómo funciona

Hace una consulta a Drive combinando con and las condiciones que indiques:

folderId: solo los hijos directos de esa carpeta (root para la raíz de Mi unidad). No entra en subcarpetas.
query: una búsqueda con la sintaxis q de Drive, p. ej. name contains 'factura', mimeType = 'application/pdf', modifiedTime > '2026-06-01T00:00:00'.
Salvo que actives includeTrashed, se añade trashed = false para dejar fuera la papelera.

Sin folderId ni query, lista todo lo que la cuenta puede ver (Mi unidad y lo compartido con ella). Devuelve hasta maxResults elementos de una sola página de resultados, como máximo 1000, sin un orden garantizado. Los elementos de unidades compartidas no aparecen.

Parámetros requeridos

Ninguno.

Parámetros opcionales

Parámetro	Tipo	Por defecto	Descripción
`session`	`ZoanGoogleDriveSession`	—	Sesión de Google Drive — Connect. Dentro del `body` de Connect se hereda y puedes omitirla.
`folderId`	`string`	—	Lista los hijos directos de esta carpeta (p. ej. `root`). Si se omite, busca en todos los archivos.
`query`	`string`	—	Búsqueda de Drive (sintaxis `q`). Se combina con `folderId` si das los dos. Ej.: `name contains 'factura'`.
`maxResults`	`int`	`100`	Número máximo de elementos (1–1000). Un valor no numérico o menor que 1 usa `100`.
`includeTrashed`	`bool`	`false`	Incluir elementos de la papelera.

Salida

Devuelve una List de Dictionary: cada elemento es un archivo o carpeta con los metadatos de un archivo (id, name, mimeType, isFolder, size, parents, modifiedTime, createdTime, webViewLink, trashed). Si nada coincide, devuelve una lista vacía, no un error. Recórrela con un For Each y accede por clave (item["name"], item["id"]).

Errores comunes

Mensaje	Causa y solución
`No hay una sesión de Google Drive disponible. Indica 'session' desde una actividad googledrive-connect o coloca esta actividad dentro del cuerpo de la actividad Connect …`	La actividad está fuera del `body` de Connect y no recibió `session`. Colócala dentro del `body` o pasa la sesión guardada.
`The service drive has thrown an exception. HttpStatusCode is BadRequest…`	La `query` tiene una sintaxis que Drive no entiende (comillas sin cerrar, campo inexistente). Las cadenas van entre comillas simples.
`The service drive has thrown an exception. HttpStatusCode is …`	Google rechazó la llamada: ID inexistente o sin acceso, token vencido o cuota superada. Ver errores de la API de Google.

Ejemplo

Descargar los PDF que llegaron a una carpeta y archivarlos en otra:

Google Drive — Connect   credential = credential("drive-operaciones")
 └─ body:
      Google Drive — List files   folderId = idEntrada   query = "mimeType = 'application/pdf'"   → output: pdfs
      For Each   items = pdfs   itemVariable = pdf
       └─ activities:
            Google Drive — Download   id = pdf["id"]   destination = "C:\entrada"   → output: ruta
            Google Drive — Move   id = pdf["id"]   folderId = idProcesados

Actividades relacionadas

Google Drive — Get info — datos de un archivo concreto.
Google Drive — Download — descargar un archivo de la lista.
Google Drive — Connect — abrir la sesión.
Todas las actividades de Google Drive