Skip to main content

Configuración básica

Puedes instalar la integración de Google Drive desde nuestro Marketplace. Una vez instalada, podrás subir archivos (desde URL o contenido base64), listar y buscar elementos con filtros, crear carpetas, mover/copiar/compartir archivos, descargar contenido y consultar metadatos.

Funcionalidades

Subir archivo

Sube un archivo a Google Drive desde una URL o contenido en base64. Soporta especificar carpeta destino y descripción. Inputs:
  • name (string) — Nombre del archivo.
  • mimeType (string) — MIME type del archivo (p. ej. text/plain, image/png, application/pdf).
  • source (enum: url | base64) — Origen del contenido.
  • content (string) — Si source = url, es la URL a descargar. Si source = base64, es el contenido codificado.
  • folderId (opcional, string) — ID de la carpeta destino.
  • description (opcional, string) — Descripción del archivo.
Ejemplo:
{
  "name": "reporte.pdf",
  "mimeType": "application/pdf",
  "source": "url",
  "content": "https://ejemplo.com/archivos/reporte.pdf",
  "folderId": "1A2B3CcarpetaID",
  "description": "Reporte mensual de ventas"
}

Listar archivos

Lista archivos de Google Drive con soporte de filtros, ordenamiento y paginación. Inputs:
  • pageSize (opcional, number) — Cantidad de resultados (por defecto 10, máximo 100).
  • pageToken (opcional, string) — Token de paginación para obtener la siguiente página.
  • folderId (opcional, string) — Filtra por carpeta (elementos hijos de esa carpeta).
  • query (opcional, string) — Filtro adicional (p. ej. name contains 'reporte').
  • orderBy (opcional, string) — Orden (por defecto modifiedTime desc).
Ejemplo:
{
  "pageSize": 25,
  "pageToken": "CAoQAA",
  "folderId": "1A2B3CcarpetaID",
  "query": "name contains 'reporte' and mimeType != 'application/vnd.google-apps.folder'",
  "orderBy": "modifiedTime desc"
}

Crear carpeta

Crea una nueva carpeta en Google Drive. Inputs:
  • name (string) — Nombre de la carpeta.
  • parentFolderId (opcional, string) — Carpeta padre.
  • description (opcional, string) — Descripción de la carpeta.
Ejemplo:
{
  "name": "Documentos 2025",
  "parentFolderId": "0B1XyZpadreID",
  "description": "Carpeta para documentos del año 2025"
}

Eliminar archivo

Elimina un archivo o carpeta de Google Drive. Inputs:
  • fileId (string) — ID del archivo o carpeta a eliminar.
Ejemplo:
{
  "fileId": "1XyZarchivoID"
}

Obtener metadatos de archivo

Obtiene metadatos detallados de un archivo o carpeta. Inputs:
  • fileId (string) — ID del archivo o carpeta.
Ejemplo:
{
  "fileId": "1XyZarchivoID"
}

Descargar archivo

Descarga un archivo de Google Drive. Para archivos pequeños (<2MB) retorna el contenido en base64; para archivos grandes retorna una downloadUrl. Inputs:
  • fileId (string) — ID del archivo a descargar.
Ejemplo:
{
  "fileId": "1XyZarchivoID"
}

Actualizar archivo

Actualiza metadatos o contenido de un archivo en Google Drive. Inputs:
  • fileId (string) — ID del archivo a actualizar.
  • name (opcional, string) — Nuevo nombre.
  • description (opcional, string) — Nueva descripción.
  • content (opcional, string) — Contenido en base64.
  • mimeType (opcional, string) — MIME type (requerido si se envía content).
Ejemplo:
{
  "fileId": "1XyZarchivoID",
  "name": "reporte-actualizado.pdf",
  "description": "Versión corregida del reporte",
  "content": "JVBERi0xLjQKJcTl8uXrp/Og0MTGCg==",
  "mimeType": "application/pdf"
}

Copiar archivo

Crea una copia de un archivo. Inputs:
  • fileId (string) — ID del archivo a copiar.
  • name (opcional, string) — Nombre para la copia (por defecto “Copy of …”).
  • folderId (opcional, string) — Carpeta destino de la copia.
Ejemplo:
{
  "fileId": "1XyZarchivoID",
  "name": "reporte-copia.pdf",
  "folderId": "1A2B3CcarpetaID"
}

Compartir archivo

Comparte un archivo o carpeta con usuarios, grupos, dominio o públicamente. Inputs:
  • fileId (string) — ID del archivo o carpeta a compartir.
  • role (enum: reader | writer | commenter | owner) — Nivel de permiso.
  • type (enum: user | group | domain | anyone) — Tipo de entidad.
  • emailAddress (opcional, string) — Correo (requerido si type es user o group).
  • domain (opcional, string) — Dominio (requerido si type es domain).
  • sendNotificationEmail (opcional, boolean) — Enviar notificación (por defecto true).
Ejemplo:
{
  "fileId": "1XyZarchivoID",
  "role": "writer",
  "type": "user",
  "emailAddress": "colaborador@ejemplo.com",
  "domain": "empresa.com",
  "sendNotificationEmail": true
}

Mover archivo

Mueve un archivo o carpeta a otra carpeta. Inputs:
  • fileId (string) — ID del archivo o carpeta a mover.
  • targetFolderId (string) — ID de la carpeta destino.
Ejemplo:
{
  "fileId": "1XyZarchivoID",
  "targetFolderId": "1A2B3CnuevaCarpetaID"
}