Google Drive — Create folder

Google Drive — Create folder

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

Crea una carpeta en Google Drive y devuelve sus datos (incluido el ID), que normalmente usarás como destino al subir o mover archivos: una carpeta por mes, por cliente o por lote procesado.

Cómo funciona

Si no indicas folderId, la carpeta se crea en la raíz de Mi unidad. Para anidarla dentro de otra carpeta, pasa el ID de la carpeta padre.

Siempre crea una carpeta nueva: Drive admite nombres repetidos, así que ejecutar dos veces con el mismo name deja dos carpetas con IDs distintos. Si la carpeta puede existir ya, búscala antes con List files (query = "name = 'Facturas 2026' and mimeType = 'application/vnd.google-apps.folder'") y créala solo si la lista está vacía.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
name	string	—	Nombre de la carpeta.

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	—	ID de la carpeta padre. Si se omite, la raíz de Mi unidad.

Salida

Devuelve un Dictionary con los metadatos de la carpeta (isFolder vale true y size es nulo). Usa carpeta["id"] como folderId de destino en Upload, Move o para crear una subcarpeta.

Errores comunes

Mensaje	Causa y solución
'name' es obligatorio.	name quedó vacío o su expresión dio nulo.
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 …	Google rechazó la llamada: ID inexistente o sin acceso, token vencido o cuota superada. Ver errores de la API de Google.

Ejemplo

Crear la carpeta del mes solo si no existe:

Google Drive — Connect   credential = credential("drive-operaciones")
 └─ body:
      Google Drive — List files   folderId = idFacturas
                                  query = "name = '2026-06' and mimeType = 'application/vnd.google-apps.folder'"
                                  → output: existentes
      If   condition = existentes.Count == 0
       ├─ then:
       │    Google Drive — Create folder   name = "2026-06"   folderId = idFacturas   → output: carpeta
       │    Set Variable   name = idMes   value = carpeta["id"]
       └─ else:
            Set Variable   name = idMes   value = existentes[0]["id"]
      Google Drive — Upload   path = "C:\fac\001.pdf"   folderId = idMes

Actividades relacionadas

• Google Drive — Upload — subir archivos a la carpeta.
• Google Drive — Move — mover archivos a la carpeta.
• Google Drive — List files — listar su contenido.
• Todas las actividades de Google Drive