API/MCP による Drive ファイルの一括操作

一括操作を使うと、統合機能は 1 回のリクエストで多数の Drive ファイルやフォルダーを処理できます。古いフォルダーのアーカイブ、誤って行ったクリーンアップの復元、生成されたレポートの移動、確認済みのゴミ箱内容の消去に役立ちます。

一括操作は多くのデータに影響する可能性があるため、控えめなスコープ、プレビュー、監査レビューを組み込んで設計してください。

一括操作でできること

Drive は以下の一括操作に対応しています。

• ファイルやフォルダーをゴミ箱へ移動する。
• ファイルやフォルダーをゴミ箱から復元する。
• ファイルやフォルダーを対象フォルダーへ移動する。
• ゴミ箱内のファイルやフォルダーを完全に消去する。

一括リクエストには、選択した ID を最大 5,000 個含められます。より大規模なクリーンアップでは、制限のない 1 つのジョブではなく、内容を確認した複数のバッチを実行してください。

ID の選択

閲覧、フォルダーツリー、検索、全選択のヘルパーを使用して ID のリストを作成します。MCP には、エージェントに手動でページを切り替えさせずに「このフォルダー内のすべて」を必要とするワークフロー向けの drive_select_all_ids が含まれています。

破壊的なバッチを実行する前に、エージェントに予定している操作を要約させてください。

• 対象の Drive スペース。
• ファイルとフォルダーの数。
• 移動する場合の移動先フォルダー。
• 操作を復元できるかどうか。
• 必要なスコープと MCP セーフティゲート。

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 を必須にすることもできます。

安全なクリーンアップのパターン

ほとんどの自動化では、2 段階のクリーンアップを使用します。

1. 古いファイルを Archive フォルダーまたはゴミ箱へ移動します。
2. 完全に消去する前に、人による確認または別にスケジュールされたメンテナンスジョブを待ちます。

これにより、復元手段を保ちながら、日常的に使うエージェントを有用な状態に保てます。

権限の設計

消去権限は別のトークンに保持してください。ファイルをアーカイブするだけのワークフローに消去権限は一切必要ありません。