Google Drive Crear, subir y listar archivos
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 Sim 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.
VIDEO
Con Google Drive, puedes:
Almacenar archivos en la nube : Sube y accede a tus archivos desde cualquier lugar con acceso a internetOrganizar contenido : Crea carpetas, usa códigos de color e implementa convenciones de nomenclaturaCompartir y colaborar : Controla los permisos de acceso y trabaja simultáneamente en archivosBuscar eficientemente : Encuentra archivos rápidamente con la potente tecnología de búsqueda de GoogleAcceder desde varios dispositivos : Usa Google Drive en plataformas de escritorio, móviles y webIntegrar con otros servicios : Conéctate con Google Docs, Sheets, Slides y aplicaciones de terceros
En Sim, 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 Sim 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 fileNamestring Sí El nombre del archivo a subir filefile No Archivo binario para subir (objeto UserFile) contentstring No Contenido de texto para subir (use esto O archivo, no ambos) mimeTypestring No El tipo MIME del archivo a subir (auto-detectado del archivo si no se proporciona) folderSelectorstring No Seleccione la carpeta donde subir el archivo folderIdstring No El ID de la carpeta donde subir el archivo (uso interno)
Parámetro Tipo Descripción filejson Metadatos del archivo subido incluyendo ID, nombre y enlaces
Crear una nueva carpeta en Google Drive
Parámetro Tipo Obligatorio Descripción fileNamestring Sí Nombre de la carpeta a crear folderSelectorstring No Seleccionar la carpeta principal donde crear la carpeta folderIdstring No ID de la carpeta principal (uso interno)
Parámetro Tipo Descripción filejson 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 fileIdstring Sí El ID del archivo a descargar mimeTypestring No El tipo MIME para exportar archivos de Google Workspace (opcional) fileNamestring No Anulación opcional del nombre del archivo
Parámetro Tipo Descripción filefile Archivo descargado almacenado en los archivos de ejecución
Listar archivos y carpetas en Google Drive
Parámetro Tipo Obligatorio Descripción folderSelectorstring No Selecciona la carpeta desde la que listar archivos folderIdstring No El ID de la carpeta desde la que listar archivos (uso interno) querystring 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. pageSizenumber No El número máximo de archivos a devolver (predeterminado: 100) pageTokenstring No El token de página para usar en la paginación
Parámetro Tipo Descripción filesjson Array de objetos de metadatos de archivos de la carpeta especificada
Categoría: tools
Tipo: google_drive
Parámetro Tipo Descripción filefile Archivo descargado almacenado en archivos de ejecución metadataobject 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 fileIdstring Sí El ID del archivo a copiar newNamestring No Nombre para el archivo copiado (por defecto "Copia de [nombre original]") destinationFolderIdstring No ID de la carpeta donde colocar la copia (por defecto la misma ubicación que el original)
Parámetro Tipo Descripción filejson 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 fileIdstring Sí El ID del archivo a actualizar namestring No Nuevo nombre para el archivo descriptionstring No Nueva descripción para el archivo addParentsstring No Lista separada por comas de IDs de carpetas principales a añadir (mueve el archivo a estas carpetas) removeParentsstring No Lista separada por comas de IDs de carpetas principales a eliminar starredboolean No Si marcar o desmarcar el archivo
Parámetro Tipo Descripción filejson 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 fileIdstring Sí El ID del archivo a mover a la papelera
Parámetro Tipo Descripción filejson 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 fileIdstring Sí El ID del archivo a eliminar permanentemente
Parámetro Tipo Descripción deletedboolean Si el archivo se eliminó correctamente fileIdstring El ID del archivo eliminado
Compartir un archivo con un usuario, grupo, dominio o hacerlo público
Parámetro Tipo Requerido Descripción fileIdstring Sí El ID del archivo a compartir typestring Sí Tipo de destinatario: user, group, domain o anyone rolestring Sí Rol de permiso: owner (transferir propiedad), organizer (solo unidad compartida), fileOrganizer (solo unidad compartida), writer (editar), commenter (ver y comentar), reader (solo ver) emailstring No Dirección de correo electrónico del usuario o grupo (requerido para type=user o type=group) domainstring No Dominio con el que compartir (requerido para type=domain) transferOwnershipboolean No Requerido cuando el rol es owner. Transfiere la propiedad al usuario especificado. moveToNewOwnersRootboolean No Al transferir la propiedad, mover el archivo a la carpeta raíz de Mi unidad del nuevo propietario. sendNotificationboolean No Si se debe enviar una notificación por correo electrónico (predeterminado: true) emailMessagestring No Mensaje personalizado para incluir en el correo electrónico de notificación
Parámetro Tipo Descripción permissionjson 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 fileIdstring Sí El ID del archivo para modificar permisos permissionIdstring Sí El ID del permiso a eliminar (usa list_permissions para encontrarlo)
Parámetro Tipo Descripción removedboolean Si el permiso fue eliminado exitosamente fileIdstring El ID del archivo permissionIdstring 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 fileIdstring Sí El ID del archivo para listar permisos
Parámetro Tipo Descripción permissionsarray 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 nextPageTokenstring 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 userjson 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 storageQuotajson 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 canCreateDrivesboolean Si el usuario puede crear unidades compartidas importFormatsjson Mapa de tipos MIME que se pueden importar y sus formatos de destino exportFormatsjson Mapa de tipos MIME de Google Workspace y sus formatos exportables maxUploadSizestring Tamaño máximo de carga en bytes