通过 API/MCP 执行 Drive 文件批量操作
通过 REST API 或 MCP 批量移动、移入回收站、恢复或永久清除 TrekMail Drive 文件，保障 AI 智能体工作流安全。
文章详情
类型、难度、套餐及最近更新信息。
▼
文章详情
类型、难度、套餐及最近更新信息。
- 类型
- 参考资料
- 难度
- 中级
- 套餐
- Starter · Pro · Agency · + Drive Add-on
- 最近更新
- 2026年9月6日
批量操作允许集成在一个请求中处理多个 Drive 文件和文件夹。它们适合用于归档旧文件夹、撤销错误的清理、移动生成的报告，或清除已经检查过的回收站内容。
由于批量操作可能影响大量数据，请使用保守的权限范围、预览和审计检查来设计这些操作。
批量操作可以执行什么任务
Drive 支持以下批量操作：
- 将文件和文件夹移入回收站。
- 从回收站恢复文件和文件夹。
- 将文件和文件夹移动到目标文件夹。
- 永久清除回收站中的文件和文件夹。
批量请求最多可以包含 5,000 个选定 ID。对于更大规模的清理，请运行多个经过检查的批次，不要使用一个不受限制的任务。
选择 ID
使用浏览、文件夹树、搜索或全选辅助工具来构建 ID 列表。MCP 提供 drive_select_all_ids，适用于需要选择“此文件夹中的所有内容”且不希望智能体手动处理分页的工作流。
执行破坏性批次之前，请让智能体概述计划执行的操作：
- 目标 Drive 空间。
- 文件和文件夹数量。
- 移动时的目标文件夹。
- 操作是否可以恢复。
- 所需权限范围和 MCP 安全控制。
REST endpoints
POST /api/v1/drive/spaces/{space}/bulk:trash
POST /api/v1/drive/spaces/{space}/bulk:restore
POST /api/v1/drive/spaces/{space}/bulk:move
POST /api/v1/drive/spaces/{space}/bulk:purge
每个批量请求都应使用 Idempotency-Key 标头。如果发生重试，TrekMail 可以返回原始结果，而不会重复执行该批次。
MCP 工具
drive_bulk_trash
drive_bulk_restore
drive_bulk_move
drive_bulk_purge
drive_bulk_purge 是永久性操作，需要对应的永久清除权限范围。在本地托管的 MCP 服务器中，管理员还可以要求设置 TREKMAIL_ALLOW_DESTRUCTIVE=true，之后才提供此工具。
安全清理模式
对于大多数自动化，请采用两步清理方式：
- 将旧文件移动到
Archive文件夹或回收站。 - 在永久清除之前，等待人工检查或单独的计划维护任务。
这样既能保持日常智能体的实用性，也能保留恢复选项。
权限设计
| 操作 | 权限范围级别 | 可恢复？ |
|---|---|---|
| 批量移动 | 写入 | 是 |
| 批量移入回收站 | 写入 | 是，直到永久清除或保留期结束 |
| 批量恢复 | 写入 | 是 |
| 批量永久清除 | 永久清除 | 否 |
请将永久清除权限放在单独的令牌中。如果工作流只归档文件，就完全不需要永久清除权限。
相关文章
跳转到延续此工作流的邻近指南。