【GAS入門#47】不要なファイルを自動で整理!File.setTrashed()で古いファイルをゴミ箱へ移動しよう

Googleドライブを使っていると、いつの間にか古いファイルが溜まって整理がつかなくなってしまうことはありませんか?

特に、毎年作成する「除雪計画案」や「月次報告書」「イベントマニュアル」などの運用資料は、年度が変わるたびに新しいファイルが作られ、過去のファイルがドライブ内に放置されがちです。「どれが最新版かわからない」「検索結果に古いファイルが引っかかって邪魔…」なんて困った経験がある方も多いはず。

前回の第46回では、処理済みのファイルを整理するために File.moveTo() を使って指定のフォルダへ移動する方法を学びました。 今回は一歩進んで、もう使わなくなった不要なファイルを安全に整理するFile.setTrashed() という命令を解説します!

「ファイルをプログラムで削除するなんて、間違えて消しちゃいそうで怖い…」と思われるかもしれませんが、安心してください。File.setTrashed() は「完全消去」ではなく、Googleドライブの「ゴミ箱」に移動する安全設計の命令です。

今回は、古い「一昨年の除雪計画案」ファイルを題材にしながら、基本的な使い方から自動整理の応用パターン、そして事故を防ぐ安全設計まで、どこよりも分かりやすく丁寧に解説していきますね!

1. そもそも File.setTrashed() とは?

File.setTrashed() は、Googleドライブ上の指定したファイルやフォルダを 「ゴミ箱」に移動させる(またはゴミ箱から復元する)ための命令(メソッド) です。

コードの基本文法と仕組み

// ファイルをゴミ箱に移動する
file.setTrashed(true);

// ファイルをゴミ箱から復元する(元に戻す)
file.setTrashed(false);

カッコの中には、true または false という真偽値(Boolean)を渡します。

  • true を渡すと:ファイルを Google ドライブの「ゴミ箱」へ移動します。
  • false を渡すと:ゴミ箱に入っていたファイルを「元の場所」へ復元します。

「シュレッダー」ではなく「デスク横のゴミ箱」

プログラミングでファイルを消すというと、一瞬で跡形もなく消え去ってしまうイメージがありますよね。 しかし、File.setTrashed() は「デスクの横にあるゴミ箱にポイと放り込む」イメージです。

  • 完全消去(シュレッダー):二度と復元できない。
  • ゴミ箱へ移動(setTrashed(true)):手違いで移動してしまっても、ゴミ箱をあさればいつでも拾い上げ(復元)ができる!

Googleドライブの仕様上、ゴミ箱に入ったファイルは30日間保持された後に自動的に完全削除されます。つまり、間違えて実行してしまっても30日以内であればリカバリーが可能という、非常にユーザーに優しい安全設計になっているのです。

2. STEP1:準備!「一昨年の除雪計画案」ファイルを用意しよう

それでは、実際にGASから操作するためのテスト環境を作成しましょう。 今回は札幌オフィスの冬の備えとして作成された古い「除雪計画案」ファイルを整理するシチュエーションで進めていきます!

手順

  1. Googleドライブを開く
    ブラウザで Google ドライブを開きます。
  2. テスト用フォルダを作成する
    「新規」>「新しいフォルダ」をクリックし、フォルダ名を 「札幌オフィス_除雪管理」 にします。
  3. テスト用ファイルを作成する
    作成したフォルダの中に入り、「新規」>「Google ドキュメント」(またはテキストファイルなど)を作成し、ファイル名を 「2024年度_除雪計画案」 にします。本文には適当に「2024年の排雪スケジュール」などと書いて保存しておきましょう。
  4. ファイルIDを取得する
    作成したファイルを開いた際、ブラウザのアドレスバー(URL)を確認してください。
    https://docs.google.com/document/d/1abc123XYZ_sample_ID_here/edit
    URLの中にある /d/ と /edit の間に挟まれた英数字の文字列(上記で言えば 1abc123XYZ_sample_ID_here)が、このファイルのファイルIDです。これをコピーしておきましょう。

3. STEP2:【実践】指定したファイルをゴミ箱へ移動してみよう!

準備ができたら、GASのエディタを開いて「2024年度_除雪計画案」ファイルをゴミ箱へ移動するプログラムを作成していきます。

1. GASのエディタ画面を開く

  1. 任意のGoogleスプレッドシート(または先ほどのドキュメント)のメニューから 「拡張機能」 > 「Apps Script」 を選択します。
  2. エディタ画面が開いたら、元々書かれているコードをすべて消去して真っ白にします。

2. コードを入力する

以下のコードをコピーして、エディタに貼り付けます('ここにファイルIDを貼り付け' の部分は、STEP1でコピーしたご自身のファイルIDに書き換えてください)。

function trashOldSnowPlan() {
  // ① 操作したいファイルのIDを指定
  var fileId = 'ここにファイルIDを貼り付け';
  
  // ② DriveAppを使ってファイルオブジェクトを取得(第41回〜第46回の復習!)
  var targetFile = DriveApp.getFileById(fileId);
  
  // ③ ファイル名をログ出力して確認
  Logger.log("移動対象のファイル名: " + targetFile.getName());
  
  // ④ ファイルをゴミ箱へ移動する
  targetFile.setTrashed(true);
  
  // ⑤ 完了ログを出力
  Logger.log("「" + targetFile.getName() + "」をゴミ箱へ移動しました!");
}

3. コードのポイントを徹底解説!

  • DriveApp.getFileById(fileId)
    第41回や第44回でも登場した、ファイルIDを使って特定のファイルを取得する基本命令です。
  • targetFile.setTrashed(true)
    本日主役の命令です!取得したファイルに対して .setTrashed(true) を呼び出すことで、即座にGoogleドライブのゴミ箱へ移動させます。

4. 保存と実行

  1. 画面上部の 「保存アイコン(フロッピーディスク)」 を押します。
  2. 実行する関数が trashOldSnowPlan になっていることを確認し、「実行」 ボタンをクリックします。
  3. 初回実行時はアクセスの承認を求められることがありますので、画面の指示に従って「許可」を行ってください(第2回で解説した手順です)。

5. 実行結果を確認する

GASのエディタ下部にある「実行ログ」を確認してみましょう。

情報    移動対象のファイル名: 2024年度_除雪計画案
情報    「2024年度_除雪計画案」をゴミ箱へ移動しました!

続いて、Googleドライブの画面に戻り、左側メニューにある 「ゴミ箱」 タブをクリックして開いてみてください。

先ほど作成した「2024年度_除雪計画案」が、しっかりゴミ箱に入っていれば大成功です!元のフォルダ「札幌オフィス_除雪管理」からは綺麗に消えていますね。

4. STEP3:実務で大活躍!フォルダ内の古いファイルを一括でゴミ箱へ自動整理しよう

1つのファイルIDを直接指定してゴミ箱に入れるだけなら、画面上でマウス操作して削除するのとあまり変わりませんよね。 GASの本領を発揮するのは、「フォルダの中にある特定の条件に当てはまる古いファイルをまとめて一括処理する」 ときです!

ここでは、実務で使える応用例として、「札幌オフィス_除雪管理」フォルダ内にあるファイルのうち、ファイル名に『2023年』や『2024年』が含まれる古い計画案を自動で検索し、まとめてゴミ箱へ移動するスクリプトをご紹介します。

一括整理の自動化コード

function autoTrashOldFiles() {
  // ① 対象フォルダのID(「札幌オフィス_除雪管理」フォルダのID)
  var folderId = 'ここにフォルダIDを貼り付け';
  var folder = DriveApp.getFolderById(folderId);
  
  // ② フォルダ内のすべてのファイルを取得(第43回の復習!)
  var files = folder.getFiles();
  var movedCount = 0;
  
  // ③ 繰り返し処理で1ファイルずつチェック
  while (files.hasNext()) {
    var file = files.next();
    var fileName = file.getName();
    
    // ④ ファイル名に「2023年」または「2024年」が含まれているか判定
    if (fileName.indexOf("2023年") !== -1 || fileName.indexOf("2024年") !== -1) {
      // 条件に一致したらゴミ箱へ移動
      file.setTrashed(true);
      Logger.log("【ゴミ箱へ移動】: " + fileName);
      movedCount++;
    } else {
      Logger.log("【保持】: " + fileName);
    }
  }
  
  Logger.log("合計 " + movedCount + " 件の古いファイルをゴミ箱へ移動しました。");
}

応用コードのポイント

  1. folder.getFiles() と while (files.hasNext())
    第43回で学んだ「ファイル一覧のループ処理」です。フォルダの中に入っているファイルを順番に1つずつチェックしていきます。
  2. fileName.indexOf("2023年") !== -1
    JavaScriptの文字検索機能です。ファイル名の中に特定キーワードが含まれているかを判定しています。
  3. 条件に合致したファイルだけを file.setTrashed(true)
    最新の「2026年度_除雪計画案」などは残しつつ、不要になった過去のファイルだけをピンポイントでゴミ箱へ送ることができます。

定期実行トリガー(第23回参照)と組み合わせれば、「毎年4月1日になったら、前々年度の古い資料を自動でゴミ箱へ移動してドライブを綺麗に保つ」 といった全自動クリーンアップシステムも簡単に作れてしまいます!

5. 超重要!初心者が絶対にハマる4大トラップと安全設計

File.setTrashed() を使う際、知っておかないと予期せぬエラーやトラブルに繋がる重要なポイントを4つまとめました。事故を防ぐためにもしっかり押さえておきましょう!

トラップ1:ゴミ箱に入ったファイルをさらに操作しようとしてエラーになる

一度 setTrashed(true) でゴミ箱に移動したファイルに対して、さらに名前を変更(setName())したり、別のフォルダへ移動(moveTo())しようとすると、GASはエラーを吐いて停止します。

Exception: ファイルはゴミ箱に入っています。

【解決策】 ファイルがゴミ箱に入っているかどうかを事前に確認したい場合は、file.isTrashed() という命令を使います。

if (!file.isTrashed()) {
  // ゴミ箱に入っていなければ処理を実行
  file.setTrashed(true);
}

isTrashed() はゴミ箱に入っていれば true、入っていなければ false を返すため、安全に条件分岐を組むことができます。

トラップ2:間違えてゴミ箱に入れてしまった!コードから復元する方法

「間違えて必要なファイルまでゴミ箱に入れちゃった…!」というときも焦る必要はありません。 Googleドライブの画面から「復元」を押すか、GASで setTrashed(false) を実行すれば即座に元に戻せます。

function restoreFile() {
  var file = DriveApp.getFileById('復元したいファイルID');
  // false を渡すとゴミ箱から元の場所へ復元される!
  file.setTrashed(false);
  Logger.log("ファイルを元にあった場所へ復元しました。");
}

トラップ3:権限不足(他人が所有する共有ファイル)で移動できない

会社のチーム共有ドライブなどで、「他の人が作成したファイル(オーナーが自分ではないファイル)」 に対して setTrashed(true) を実行すると、権限エラーが発生することがあります。

Googleドライブの基本ルールとして、ファイルをゴミ箱に入れられるのは原則としてそのファイルの所有者(オーナー)または十分な編集権限を持つユーザーのみです。 エラーが出る場合は、ファイルの所有権が誰にあるかを確認してみましょう。

トラップ4:完全削除(DriveApp.removeFile 等)との勘違い

GASの古い解説サイトなどを見ていると、DriveApp.removeFile() や Folder.removeFile() といった命令を見かけることがあります。これらは「フォルダからのリンクを解除する」などの特殊な挙動をする場合があり、初心者の方が使うと意図しない動作を引き起こす原因になります。

現代のGAS開発においては、不要になったファイルは File.setTrashed(true) を使ってゴミ箱に移動するのが最も標準的かつ安全な手法です。

6. 今回のまとめと次回予告

今回は、不要になったファイルを安全にゴミ箱へ移動する File.setTrashed() について詳しく解説しました。

本日の重要ポイント

  1. file.setTrashed(true) はファイルをGoogleドライブの「ゴミ箱」へ移動する命令
  2. 完全消去ではなくゴミ箱への移動なので、30日以内なら復元可能で安全性抜群!
  3. file.setTrashed(false) を使えばプログラムから元の場所へ復元できる
  4. file.isTrashed() でゴミ箱に入っているかどうかを事前にチェックできる
  5. ループ処理と組み合わせることで、古い不要ファイルを一括自動クリーニングできる

これで、ファイルの取得(第41回)、作成(第42回)、一覧取得(第43回)、コピー(第44回)、リネーム(第45回)、移動(第46回)、そして整理・ゴミ箱移動(第47回)と、Googleドライブ内のファイル操作に関する一通りの技術がマスターできましたね!

さて、ファイルたちの「整理整頓」ができるようになると、今度はファイルを入れるための「新しい箱(フォルダ)」をGASから自由に作成したくなりますよね!

次回(第48回)は、DriveApp.createFolder() をお届けします!