Google Drive es el servicio de almacenamiento en la nube y sincronización de archivos de Google que permite a los usuarios almacenar archivos, sincronizarlos entre dispositivos y compartirlos con otros. Como componente central del ecosistema de productividad de Google, Google Drive ofrece capacidades robustas de almacenamiento, organización y colaboración.
Aprende cómo integrar la herramienta Google Drive en Aptlystar para extraer información de tu Drive sin esfuerzo a través de tus flujos de trabajo. Este tutorial te guía a través de la conexión con Google Drive, la configuración de la recuperación de datos y el uso de documentos y archivos almacenados para mejorar la automatización. Perfecto para sincronizar datos importantes con tus agentes en tiempo real.
Con Google Drive, puedes:
- Almacenar archivos en la nube: Sube y accede a tus archivos desde cualquier lugar con acceso a internet
- Organizar contenido: Crea carpetas, usa códigos de color e implementa convenciones de nomenclatura
- Compartir y colaborar: Controla los permisos de acceso y trabaja simultáneamente en archivos
- Buscar eficientemente: Encuentra archivos rápidamente con la potente tecnología de búsqueda de Google
- Acceder desde varios dispositivos: Usa Google Drive en plataformas de escritorio, móviles y web
- Integrar con otros servicios: Conéctate con Google Docs, Sheets, Slides y aplicaciones de terceros
En Aptlystar, la integración con Google Drive permite a tus agentes interactuar directamente con tu almacenamiento en la nube de forma programática. Esto permite potentes escenarios de automatización como gestión de archivos, organización de contenido y flujos de trabajo de documentos. Tus agentes pueden subir nuevos archivos a carpetas específicas, descargar archivos existentes para procesar su contenido y listar el contenido de carpetas para navegar por la estructura de almacenamiento. Esta integración cierra la brecha entre tus flujos de trabajo de IA y tu sistema de gestión de documentos, permitiendo operaciones de archivos sin intervención manual. Al conectar Aptlystar con Google Drive, puedes automatizar flujos de trabajo basados en archivos, gestionar documentos de manera inteligente e incorporar operaciones de almacenamiento en la nube a las capacidades de tu agente.
Integra Google Drive en el flujo de trabajo. Puede crear, subir y listar archivos. Requiere OAuth.
Subir un archivo a Google Drive
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
fileName | string | Sí | El nombre del archivo a subir |
file | file | No | Archivo binario para subir (objeto UserFile) |
content | string | No | Contenido de texto para subir (use esto O archivo, no ambos) |
mimeType | string | No | El tipo MIME del archivo a subir (auto-detectado del archivo si no se proporciona) |
folderSelector | string | No | Seleccione la carpeta donde subir el archivo |
folderId | string | No | El ID de la carpeta donde subir el archivo (uso interno) |
| Parámetro | Tipo | Descripción |
|---|
file | json | Metadatos del archivo subido incluyendo ID, nombre y enlaces |
Crear una nueva carpeta en Google Drive
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
fileName | string | Sí | Nombre de la carpeta a crear |
folderSelector | string | No | Seleccionar la carpeta principal donde crear la carpeta |
folderId | string | No | ID de la carpeta principal (uso interno) |
| Parámetro | Tipo | Descripción |
|---|
file | json | Metadatos de la carpeta creada incluyendo ID, nombre e información de la carpeta principal |
Descargar un archivo de Google Drive (exporta automáticamente archivos de Google Workspace)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
fileId | string | Sí | El ID del archivo a descargar |
mimeType | string | No | El tipo MIME para exportar archivos de Google Workspace (opcional) |
fileName | string | No | Anulación opcional del nombre del archivo |
| Parámetro | Tipo | Descripción |
|---|
file | file | Archivo descargado almacenado en los archivos de ejecución |
Listar archivos y carpetas en Google Drive
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
folderSelector | string | No | Selecciona la carpeta desde la que listar archivos |
folderId | string | No | El ID de la carpeta desde la que listar archivos (uso interno) |
query | string | No | Término de búsqueda para filtrar archivos por nombre (p. ej. "presupuesto" encuentra archivos con "presupuesto" en el nombre). NO uses la sintaxis de consulta de Google Drive aquí - solo proporciona un término de búsqueda simple. |
pageSize | number | No | El número máximo de archivos a devolver (predeterminado: 100) |
pageToken | string | No | El token de página para usar en la paginación |
| Parámetro | Tipo | Descripción |
|---|
files | json | Array de objetos de metadatos de archivos de la carpeta especificada |
- Categoría:
tools
- Tipo:
google_drive
| Parámetro | Tipo | Descripción |
|---|
file | file | Archivo descargado almacenado en archivos de ejecución |
metadata | object | Metadatos completos del archivo desde Google Drive |
↳ id | string | ID del archivo de Google Drive |
↳ kind | string | Identificador del tipo de recurso |
↳ name | string | Nombre del archivo |
↳ mimeType | string | Tipo MIME |
↳ description | string | Descripción del archivo |
↳ originalFilename | string | Nombre del archivo original subido |
↳ fullFileExtension | string | Extensión completa del archivo |
↳ fileExtension | string | Extensión del archivo |
↳ owners | json | Lista de propietarios del archivo |
↳ permissions | json | Permisos del archivo |
↳ permissionIds | json | IDs de permisos |
↳ shared | boolean | Si el archivo está compartido |
↳ ownedByMe | boolean | Si es propiedad del usuario actual |
↳ writersCanShare | boolean | Si los editores pueden compartir |
↳ viewersCanCopyContent | boolean | Si los lectores pueden copiar |
↳ copyRequiresWriterPermission | boolean | Si copiar requiere permiso de editor |
↳ sharingUser | json | Usuario que compartió el archivo |
↳ starred | boolean | Si el archivo está destacado |
↳ trashed | boolean | Si el archivo está en la papelera |
↳ explicitlyTrashed | boolean | Si fue eliminado explícitamente |
↳ appProperties | json | Propiedades específicas de la aplicación |
↳ createdTime | string | Hora de creación del archivo |
↳ modifiedTime | string | Hora de última modificación |
↳ modifiedByMeTime | string | Cuándo fue modificado por el usuario actual |
↳ viewedByMeTime | string | Cuándo fue visto por última vez por el usuario actual |
↳ sharedWithMeTime | string | Cuándo fue compartido con el usuario actual |
↳ lastModifyingUser | json | Usuario que modificó el archivo por última vez |
↳ viewedByMe | boolean | Si fue visto por el usuario actual |
↳ modifiedByMe | boolean | Si fue modificado por el usuario actual |
↳ webViewLink | string | URL para ver en el navegador |
↳ webContentLink | string | URL de descarga directa |
↳ iconLink | string | URL del icono del archivo |
↳ thumbnailLink | string | URL de la miniatura |
↳ exportLinks | json | Enlaces de formatos de exportación |
↳ size | string | Tamaño del archivo en bytes |
↳ quotaBytesUsed | string | Cuota de almacenamiento utilizada |
↳ md5Checksum | string | Hash MD5 |
↳ sha1Checksum | string | Hash SHA-1 |
↳ sha256Checksum | string | Hash SHA-256 |
↳ parents | json | IDs de carpetas principales |
↳ spaces | json | Espacios que contienen el archivo |
↳ driveId | string | ID de unidad compartida |
↳ capabilities | json | Capacidades del usuario sobre el archivo |
↳ version | string | Número de versión |
↳ headRevisionId | string | ID de revisión principal |
↳ hasThumbnail | boolean | Si tiene miniatura |
↳ thumbnailVersion | string | Versión de la miniatura |
↳ imageMediaMetadata | json | Metadatos específicos de imagen |
↳ videoMediaMetadata | json | Metadatos específicos de video |
↳ isAppAuthorized | boolean | Si fue creado por la aplicación solicitante |
↳ contentRestrictions | json | Restricciones de contenido |
↳ linkShareMetadata | json | Metadatos de enlace compartido |
↳ revisions | json | Historial de revisiones del archivo (solo las primeras 100 revisiones) |
Crear una copia de un archivo en Google Drive
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
fileId | string | Sí | El ID del archivo a copiar |
newName | string | No | Nombre para el archivo copiado (por defecto "Copia de [nombre original]") |
destinationFolderId | string | No | ID de la carpeta donde colocar la copia (por defecto la misma ubicación que el original) |
| Parámetro | Tipo | Descripción |
|---|
file | json | Los metadatos del archivo copiado |
↳ id | string | ID del archivo de Google Drive de la copia |
↳ kind | string | Identificador del tipo de recurso |
↳ name | string | Nombre del archivo |
↳ mimeType | string | Tipo MIME |
↳ webViewLink | string | URL para ver en el navegador |
↳ parents | json | IDs de carpetas principales |
↳ createdTime | string | Hora de creación del archivo |
↳ modifiedTime | string | Hora de última modificación |
↳ owners | json | Lista de propietarios del archivo |
↳ size | string | Tamaño del archivo en bytes |
Actualizar metadatos de archivo en Google Drive (renombrar, mover, marcar, añadir descripción)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
fileId | string | Sí | El ID del archivo a actualizar |
name | string | No | Nuevo nombre para el archivo |
description | string | No | Nueva descripción para el archivo |
addParents | string | No | Lista separada por comas de IDs de carpetas principales a añadir (mueve el archivo a estas carpetas) |
removeParents | string | No | Lista separada por comas de IDs de carpetas principales a eliminar |
starred | boolean | No | Si marcar o desmarcar el archivo |
| Parámetro | Tipo | Descripción |
|---|
file | json | Los metadatos del archivo actualizado |
↳ id | string | ID del archivo de Google Drive |
↳ kind | string | Identificador del tipo de recurso |
↳ name | string | Nombre del archivo |
↳ mimeType | string | Tipo MIME |
↳ description | string | Descripción del archivo |
↳ starred | boolean | Si el archivo está marcado con estrella |
↳ webViewLink | string | URL para ver en el navegador |
↳ parents | json | IDs de carpetas principales |
↳ modifiedTime | string | Hora de la última modificación |
Mover un archivo a la papelera en Google Drive (se puede restaurar más tarde)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
fileId | string | Sí | El ID del archivo a mover a la papelera |
| Parámetro | Tipo | Descripción |
|---|
file | json | Los metadatos del archivo en la papelera |
↳ id | string | ID del archivo de Google Drive |
↳ kind | string | Identificador del tipo de recurso |
↳ name | string | Nombre del archivo |
↳ mimeType | string | Tipo MIME |
↳ trashed | boolean | Si el archivo está en la papelera (debería ser true) |
↳ trashedTime | string | Cuándo se movió el archivo a la papelera |
↳ webViewLink | string | URL para ver en el navegador |
Eliminar permanentemente un archivo de Google Drive (omite la papelera)
| Parámetro | Tipo | Requerido | Descripción |
|---|
fileId | string | Sí | El ID del archivo a eliminar permanentemente |
| Parámetro | Tipo | Descripción |
|---|
deleted | boolean | Si el archivo se eliminó correctamente |
fileId | string | El ID del archivo eliminado |
Compartir un archivo con un usuario, grupo, dominio o hacerlo público
| Parámetro | Tipo | Requerido | Descripción |
|---|
fileId | string | Sí | El ID del archivo a compartir |
type | string | Sí | Tipo de destinatario: user, group, domain o anyone |
role | string | Sí | Rol de permiso: owner (transferir propiedad), organizer (solo unidad compartida), fileOrganizer (solo unidad compartida), writer (editar), commenter (ver y comentar), reader (solo ver) |
email | string | No | Dirección de correo electrónico del usuario o grupo (requerido para type=user o type=group) |
domain | string | No | Dominio con el que compartir (requerido para type=domain) |
transferOwnership | boolean | No | Requerido cuando el rol es owner. Transfiere la propiedad al usuario especificado. |
moveToNewOwnersRoot | boolean | No | Al transferir la propiedad, mover el archivo a la carpeta raíz de Mi unidad del nuevo propietario. |
sendNotification | boolean | No | Si se debe enviar una notificación por correo electrónico (predeterminado: true) |
emailMessage | string | No | Mensaje personalizado para incluir en el correo electrónico de notificación |
| Parámetro | Tipo | Descripción |
|---|
permission | json | Los detalles del permiso creado |
↳ id | string | ID del permiso |
↳ type | string | Tipo de beneficiario (user, group, domain, anyone) |
↳ role | string | Rol del permiso |
↳ emailAddress | string | Correo electrónico del beneficiario |
↳ displayName | string | Nombre para mostrar del beneficiario |
↳ domain | string | Dominio del beneficiario |
↳ expirationTime | string | Fecha de expiración |
↳ deleted | boolean | Si el beneficiario está eliminado |
Eliminar un permiso de un archivo (revocar acceso)
| Parámetro | Tipo | Requerido | Descripción |
|---|
fileId | string | Sí | El ID del archivo para modificar permisos |
permissionId | string | Sí | El ID del permiso a eliminar (usa list_permissions para encontrarlo) |
| Parámetro | Tipo | Descripción |
|---|
removed | boolean | Si el permiso fue eliminado exitosamente |
fileId | string | El ID del archivo |
permissionId | string | El ID del permiso eliminado |
Listar todos los permisos (quién tiene acceso) de un archivo en Google Drive
| Parámetro | Tipo | Requerido | Descripción |
|---|
fileId | string | Sí | El ID del archivo para listar permisos |
| Parámetro | Tipo | Descripción |
|---|
permissions | array | Lista de permisos del archivo |
↳ id | string | ID del permiso (usar para eliminar permiso) |
↳ type | string | Tipo de beneficiario (user, group, domain, anyone) |
↳ role | string | Rol del permiso (owner, organizer, fileOrganizer, writer, commenter, reader) |
↳ emailAddress | string | Correo electrónico del beneficiario |
↳ displayName | string | Nombre para mostrar del beneficiario |
↳ photoLink | string | URL de la foto del beneficiario |
↳ domain | string | Dominio del beneficiario |
↳ expirationTime | string | Cuándo expira el permiso |
↳ deleted | boolean | Si la cuenta del beneficiario está eliminada |
↳ allowFileDiscovery | boolean | Si el archivo es detectable por el beneficiario |
↳ pendingOwner | boolean | Si la transferencia de propiedad está pendiente |
↳ permissionDetails | json | Detalles sobre permisos heredados |
nextPageToken | string | Token para obtener la siguiente página de permisos |
Obtener información sobre el usuario y su Google Drive (cuota de almacenamiento, capacidades)
| Parámetro | Tipo | Obligatorio | Descripción |
|---|
| Parámetro | Tipo | Descripción |
|---|
user | json | Información sobre el usuario autenticado |
↳ displayName | string | Nombre para mostrar del usuario |
↳ emailAddress | string | Dirección de correo electrónico del usuario |
↳ photoLink | string | URL de la foto de perfil del usuario |
↳ permissionId | string | ID de permiso del usuario |
↳ me | boolean | Si este es el usuario autenticado |
storageQuota | json | Información de cuota de almacenamiento en bytes |
↳ limit | string | Límite total de almacenamiento en bytes (null para ilimitado) |
↳ usage | string | Almacenamiento total usado en bytes |
↳ usageInDrive | string | Almacenamiento usado por archivos de Drive en bytes |
↳ usageInDriveTrash | string | Almacenamiento usado por archivos en la papelera en bytes |
canCreateDrives | boolean | Si el usuario puede crear unidades compartidas |
importFormats | json | Mapa de tipos MIME que se pueden importar y sus formatos de destino |
exportFormats | json | Mapa de tipos MIME de Google Workspace y sus formatos exportables |
maxUploadSize | string | Tamaño máximo de carga en bytes |
