Google Drive — Upload

Google Drive — Upload

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

Sube un archivo del equipo a Google Drive. Puedes elegir el nombre con el que queda en Drive y la carpeta de destino, y recibes su ID y su enlace para compartirlo o registrarlo.

Cómo funciona

Lee el archivo de path y lo sube con una subida reanudable, apta para archivos grandes. Si no indicas folderId, queda en la raíz de Mi unidad (con una service account sin impersonateUser, en el Drive propio de la service account). Para subirlo a una carpeta concreta, usa su ID (de List files o Create folder).

• El archivo se sube tal cual: un .xlsx sigue siendo un .xlsx, no se convierte a Hojas de cálculo de Google.
• Siempre crea un archivo nuevo: Drive admite nombres repetidos, así que subir dos veces el mismo archivo deja dos copias con IDs distintos. Para evitarlo, busca antes con List files (name = '…') y borra o renombra el anterior.

Parámetros requeridos

Parámetro	Tipo	Por defecto	Descripción
path	string	—	Ruta del archivo local a subir.

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.
name	string	—	Nombre en Drive. Si se omite, el nombre del archivo local.
folderId	string	—	ID de la carpeta de destino. Si se omite, la raíz de Mi unidad; root la indica de forma explícita.

Salida

Devuelve un Dictionary con los metadatos del archivo creado: subido["id"] (úsalo para compartir, mover o descargar), subido["name"], subido["size"], subido["webViewLink"] (enlace para abrirlo en el navegador), subido["parents"]…

Errores comunes

Mensaje	Causa y solución
'path' es obligatorio.	path quedó vacío o su expresión dio nulo.
No se encontró el archivo local.	No existe un archivo en path en el equipo del robot. Compruébalo antes con las actividades de archivos.
Falló la subida: …	La subida se interrumpió (red, cuota de almacenamiento llena, carpeta sin permiso de escritura). El texto tras los dos puntos da el detalle de Google.
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

Google Drive — Connect   credential = credential("drive-operaciones")
 └─ body:
      Google Drive — Create folder   name = "Informes"   → output: carpeta
      Google Drive — Upload   path = "C:\reportes\hoy.pdf"   folderId = carpeta["id"]   → output: subido
      Google Drive — Share    id = subido["id"]   role = reader   type = anyone

Actividades relacionadas

• Google Drive — Download — descargar un archivo.
• Google Drive — Create folder — crear la carpeta de destino.
• Google Drive — Share — compartir el archivo subido.
• Todas las actividades de Google Drive