Conecta tu cuenta de Google Drive a Goodweek para acceder, subir y gestionar archivos y carpetas almacenados en Google Drive directamente desde tu espacio de trabajo de IA.
ℹ️ Nota de gobernanza
Goodweek nunca superará los niveles de acceso otorgados al usuario dentro de Google Drive, garantizando el cumplimiento de las políticas de gobernanza de tu organización. Los resultados y las funciones disponibles pueden variar según los permisos específicos y el acceso autenticado de cada usuario.
📋 Requisitos previos
Antes de que cualquier usuario pueda ver y conectar la integración de Google Drive, el administrador de tu organización debe habilitarla primero desde el Panel de administración de Goodweek, en la pestaña Integraciones.
Configuración del administrador
Cuentas personales de Google (@gmail.com)
No se requiere configuración de administrador. Conéctate directamente siguiendo los pasos de Conexión del usuario que se indican a continuación.
Cuentas de Google Workspace (trabajo o centro educativo)
Google Drive solicita permisos de acceso a archivos muy amplios, que los administradores de Google Workspace suelen marcar como de alto riesgo. Esto hace que la restricción administrativa sea más probable para Drive que para otras integraciones de Google.
Escenario 1: predeterminado (acceso de terceros sin restricciones)
Cualquier usuario puede conectarse directamente sin intervención del administrador.
Escenario 2: el acceso de terceros está restringido (error admin_policy_enforced)
Un superadministrador de Google Workspace debe marcar Composio como aplicación de confianza:
Inicia sesión en admin.google.com como superadministrador.
Ve a Seguridad → Control de acceso y datos → Controles de API → Gestionar el acceso de aplicaciones de terceros.
Haz clic en Configurar nueva aplicación, busca Composio, seléccionala, establece el acceso como De confianza y haz clic en Guardar.
Escenario 3: todo el acceso de API de terceros está bloqueado
Ve a admin.google.com → Seguridad → Controles de API y revisa la configuración "Acceso de aplicaciones de terceros a las API de Google". Si está bloqueado, el administrador debe crear una excepción para Composio antes de seguir el Escenario 2.
Conexión del usuario
En Goodweek, ve a Integraciones.
Busca Google Drive y haz clic en Conectar.
Serás redirigido a Google, donde se te pedirá que inicies sesión.
Revisa los permisos solicitados y haz clic en Permitir para volver a Goodweek.
Notas importantes
Cada usuario debe conectar su propia cuenta individualmente.
Goodweek solo puede acceder a los archivos y carpetas que tu cuenta de usuario individual tenga permiso para ver. Los archivos compartidos solo son accesibles si se te han otorgado los permisos de uso compartido adecuados.
Si tienes varias cuentas de Google, asegúrate de seleccionar la correcta durante el paso de conexión.
Puedes revocar el acceso de Goodweek en cualquier momento desde myaccount.google.com → Seguridad → Aplicaciones de terceros con acceso a la cuenta.
Herramientas disponibles
Herramienta | Descripción | Tipo |
Find File | Búsqueda exhaustiva en Google Drive de archivos y carpetas por nombre, tipo, contenido y otros filtros. | Lectura |
Find Folder | Busca carpetas por nombre dentro de una carpeta principal en Google Drive. | Lectura |
Get File Metadata | Recupera los metadatos de un archivo por ID, incluidos el tipo, las carpetas principales y el estado de papelera. | Lectura |
Download a File from Google Drive | Descarga un archivo de Google Drive por su ID, con formato de exportación opcional para documentos de Google Workspace. | Lectura |
Export Google Workspace File | Exporta un documento de Google Workspace (Docs, Sheets, Slides) a un tipo MIME solicitado, como PDF o DOCX. | Lectura |
Create File or Folder | Crea un nuevo archivo o carpeta en Google Drive, con compatibilidad para la creación solo de metadatos y la carga de archivos con contenido. | Escritura |
Create a File from Text | Crea un nuevo archivo en Google Drive a partir del contenido de texto proporcionado, con conversión opcional a formatos de Google Workspace. | Escritura |
Create a Folder | Crea una nueva carpeta en Google Drive, opcionalmente dentro de una carpeta principal existente. | Escritura |
Upload File | Sube un archivo (máx. 5 MB) a Google Drive, colocándolo en la carpeta especificada o en la raíz. | Escritura |
Upload File from URL to Drive | Obtiene un archivo desde una URL pública y lo sube directamente a Google Drive. | Escritura |
Upload/Update File Content | Reemplaza el contenido de un archivo existente en Google Drive con contenido nuevo. | Escritura |
Edit File | Actualiza un archivo de texto existente en Google Drive sobrescribiendo todo su contenido (máx. 10 MB). | Lectura |
Move File | Mueve un archivo de una carpeta a otra en Google Drive. | Lectura |
Copy File with Advanced Options | Crea una copia de un archivo con actualizaciones opcionales aplicadas mediante semántica de parche. | Lectura |
Create Shortcut to File/Folder | Crea un acceso directo a un elemento existente de Drive desde otra ubicación sin duplicarlo. | Escritura |
Create Permission | Comparte un archivo o carpeta con un usuario, grupo o dominio mediante la creación de un nuevo permiso. | Escritura |
Create Permissions Batch | Crea varios permisos de uso compartido para archivos o unidades compartidas en una sola solicitud por lotes. | Escritura |
List Permissions | Recupera todos los permisos asociados a un archivo o unidad compartida específicos. | Lectura |
Update Permission | Modifica un permiso de uso compartido existente para un archivo o unidad compartida. | Escritura |
Create Comment | Crea un comentario en un archivo de Google Drive. | Escritura |
List Comments | Enumera todos los comentarios de un archivo en Google Drive con paginación. | Lectura |
Update Comment | Actualiza el contenido de un comentario existente en un archivo de Google Drive. | Escritura |
Create Reply | Crea una respuesta a un comentario en un archivo de Google Drive. | Escritura |
List File Revisions | Enumera los metadatos del historial de revisiones de un archivo en Google Drive. | Lectura |
Create Shared Drive | Crea una nueva unidad compartida para la colaboración en equipo. | Escritura |
List Shared Drives | Enumera todas las unidades compartidas accesibles para el usuario autenticado. | Lectura |
Untrash File | Restaura un archivo desde la papelera. | Escritura |
Get About | Recupera información sobre el usuario, su cuota de almacenamiento de Drive y las funciones del sistema. | Lectura |
Delete Permission | Revoca un permiso de uso compartido de un archivo. Esta acción es irreversible. | ⚠️ Destructivo |
Trash File | Mueve un archivo o carpeta a la papelera (eliminación reversible, recuperable). | ⚠️ Destructivo |
Delete Folder or File | Elimina permanentemente un archivo o carpeta de Google Drive. Esta acción es irreversible. | ⚠️ Destructivo |
Empty Trash | Elimina de forma permanente e irreversible todos los archivos de la papelera en Google Drive del usuario. | ⚠️ Destructivo |
Casos de uso
Encuentra y recupera archivos bajo demanda. Busca en tu Google Drive por nombre, tipo o contenido y trae metadatos o contenido de archivos a una conversación de Goodweek sin navegar por la interfaz de Drive.
Sube y organiza archivos en Drive. Sube nuevos archivos a una carpeta específica, crea estructuras de carpetas o mueve archivos existentes entre ubicaciones desde Goodweek.
Comparte archivos con personas o equipos específicos. Otorga o actualiza permisos de uso compartido en archivos y carpetas directamente desde Goodweek, sin abrir manualmente la configuración de Drive.
Exporta documentos de Google Workspace. Exporta un Google Doc, Sheet o Slide a PDF u otro formato directamente desde Goodweek para compartir o archivar.
Solución de problemas
"Error 400: admin_policy_enforced" al conectar
El administrador de tu organización ha restringido el acceso de aplicaciones de terceros. Los permisos amplios de acceso a archivos de Google Drive hacen que esto sea especialmente común. Solo un superadministrador de Google Workspace puede solucionarlo siguiendo el Escenario 2 anterior.
Integración no visible en Goodweek
Asegúrate de que el administrador de tu organización haya habilitado la integración de Google Drive desde el Panel de administración de Goodweek, en la pestaña Integraciones.