Массовые операции с файлами Drive через API/MCP

Массовые операции позволяют интеграции работать со множеством файлов и папок Drive в одном запросе. Они полезны для архивирования старых папок, отмены ошибочной очистки, перемещения созданных отчётов или удаления проверенного содержимого корзины.

Поскольку массовые действия могут затронуть большой объём данных, проектируйте их с ограниченными правами, предварительным просмотром и проверкой журнала аудита.

Возможности массовых операций

Drive поддерживает массовые действия для следующих задач:

• Отправка файлов и папок в корзину.
• Восстановление файлов и папок из корзины.
• Перемещение файлов и папок в целевую папку.
• Безвозвратное удаление файлов и папок из корзины.

Массовые запросы могут содержать до 5 000 выбранных идентификаторов. Для более масштабной очистки запускайте несколько проверенных пакетов, а не одну неограниченную задачу.

Выбор идентификаторов

Используйте вспомогательные функции просмотра, дерева папок, поиска или выбора всех элементов, чтобы составить список идентификаторов. MCP включает drive_select_all_ids для процессов, которым нужно выбрать «всё в этой папке», не заставляя агента вручную переключать страницы.

Перед запуском пакета разрушительных операций попросите агента кратко описать запланированное действие:

• Целевое пространство Drive.
• Количество файлов и папок.
• Папка назначения при перемещении.
• Возможность восстановления после операции.
• Требуемое право и механизм безопасности MCP.

Endpoints REST

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, прежде чем инструмент станет доступен.

Схема безопасной очистки

Для большинства автоматизаций используйте очистку в два этапа:

1. Переместите старые файлы в папку Archive или в корзину.
2. Перед безвозвратным удалением дождитесь проверки человеком или отдельной запланированной задачи обслуживания.

Так повседневный агент остаётся полезным, а возможность восстановления сохраняется.

Проектирование разрешений

Храните право на безвозвратное удаление в отдельном токене. Если процесс только архивирует файлы, это право ему вообще не требуется.

Связанные статьи

• Массовые операции с файлами
• Безопасность Drive, журнал аудита и правила безопасного/безвозвратного удаления
• Обзор инструментов Drive MCP