Guía de la API y MCP para enlaces compartidos de Drive

Los enlaces compartidos permiten entregar un archivo de Drive fuera de tu cuenta de TrekMail sin enviar un adjunto de correo de gran tamaño. La API y las herramientas MCP pueden crear enlaces, enumerar los enlaces de un archivo y revocarlos cuando deba finalizar el acceso.

Utiliza enlaces compartidos para entregas a clientes, facturas, archivos de vídeo, paquetes de exportación y cualquier archivo demasiado grande o temporal para adjuntarlo a un correo.

Ámbitos necesarios

Para los archivos de Drive de la cuenta, utiliza drive:account:share. Para los archivos de Drive del buzón, utiliza drive:mailbox:share. También resulta útil un ámbito de lectura, porque la mayoría de los flujos necesitan encontrar el archivo antes de compartirlo.

Los ámbitos para compartir no permiten cargar, renombrar, mover, enviar a la papelera, restaurar ni purgar archivos. Mantenlos separados cuando la única tarea del agente sea la entrega.

Crear un enlace con REST

curl -s -X POST "https://trekmail.net/api/v1/drive/files/{FILE_ID}/share-links" \
  -H "Authorization: Bearer tm_live_your_token" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: share-{FILE_ID}-client-a" \
  -d '{"expires_at":"2026-06-01T00:00:00Z","max_downloads":25}'

La respuesta incluye la URL pública. El token de uso compartido sin procesar solo se devuelve al crear el enlace. Si lo pierdes, revoca el enlace y crea uno nuevo.

Crear un enlace con MCP

drive_share_create(file_id=123, expires_at="2026-06-01T00:00:00Z", max_downloads=25)

Pide al agente que incluya la URL en su respuesta final y que indique la caducidad y el límite de descargas.

Enumerar y revocar enlaces

Utiliza el endpoint de lista o drive_share_list para ver los enlaces activos e históricos de un archivo. Revoca un enlace cuando se haya enviado a la persona equivocada, un contrato ya no sea válido o haya terminado un periodo de entrega temporal.

drive_share_revoke(link_id=456)

La revocación es inmediata. Crea un enlace nuevo si debe restaurarse el acceso.

Valores predeterminados recomendados

Los enlaces ilimitados son prácticos, pero posteriormente resulta más difícil evaluar su situación. Si decides no establecer caducidad, añade una nota en tu propio sistema que explique el motivo.

Comportamiento de seguridad

Un enlace compartido es público para cualquiera que tenga la URL. Está protegido por un token imposible de adivinar, no por un inicio de sesión de TrekMail. No envíes enlaces públicos para archivos que requieran acceso de destinatarios concretos, salvo que tu organización acepte ese modelo.

La página de descarga no revela detalles innecesarios de la cuenta. Los enlaces caducados, revocados o que han agotado su límite fallan sin exponer información privada del archivo.

Registro de auditoría

La creación y revocación de enlaces compartidos se auditan con la identidad del token de API. Si un agente crea enlaces para clientes, revisa periódicamente el registro de auditoría y rota los tokens cuando cambien las responsabilidades del equipo.