【GAS入門#46】ファイルを別フォルダへ自動移動!File.moveTo()の使い方とGoogle Drive整理術

Google Driveで日々業務や作業をしていると、気づかないうちにファイルが増えてフォルダの中がごちゃごちゃに散らかってしまうことってありますよね。

たとえば、毎月の経費精算や領収書の管理。「処理が終わった領収書PDF」や「確認済みの報告書」を、いちいちマウスでドラッグ&ドロップして「2026年_冬」や「処理済み」といった専用フォルダへ手動で動かすのは、枚数が増えるほど本当に大変です。うっかり違うフォルダに落として迷子にしてしまう誤操作のリスクもあります。

出張の交通費など、定期的に整理したいファイルがどんどん溜まります。これらをプログラムで自動的にサクッと指定のフォルダへ移動できたら、業務効率が劇的にアップしますよね!

そこで今回学ぶのが、Google Drive上のファイルを指定したフォルダへ一瞬で移動させることができる命令 File.moveTo() です!

[第41回]で学んだ DriveApp.getFolderById() や、[第44回]の File.makeCopy()、[第45回]の File.setName() と組み合わせることで、ファイル名の変更からフォルダ分けまで、Google Driveのファイル整理を完全に自動化できます。

本記事では、File.moveTo() の基本的な文法から、実際のコード例、実務で使える応用テクニック、そして初心者が100%ハマりやすい注意点まで、どこよりも分かりやすく徹底解説します!

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

File.moveTo() は、Google Apps Script(GAS)を使って 「指定したファイルを、目的のフォルダへ移動させる」 ための命令(メソッド)です。

コードの文法と構造

文法はとてもシンプルで直感的です。

file.moveTo(destinationFolder);
  • file:移動させたいファイル(File オブジェクト)
  • .moveTo()(ムーブ・トゥー):「指定したフォルダへ移動してね!」と頼む命令
  • destinationFolder:移動先のフォルダ(Folder オブジェクト)

日常で例えるなら、「デスクの上に置いてある書類(file)を手に取り、整理棚の『2026年_冬』というラベルが貼られた引き出し(destinationFolder)の中へ入れ直す操作」 を、GASのロボットに代行してもらうイメージです。

💡 昔のGAS(Drive API)を知っている人が感動するポイント!

実は昔のGASでは、ファイルを移動させるために「移動先のフォルダに追加して、移動元のフォルダから削除する」という、少しややこしい手順(addFolder() と removeFolder() の組み合わせ)が必要でした。

しかし現在では、今回学習する File.moveTo() が登場したおかげで、たった1行のコードでスマートに移動が完了する ようになりました!

2. 準備!テスト用ファイルとフォルダを用意しよう

まずは、GASから実際にファイルを移動させるためのテスト環境をGoogle Drive上に作っていきましょう。

手順

  1. 移動先のフォルダを作成する
    • Google Driveを開き、「新規」>「新しいフォルダ」をクリックします。
    • フォルダ名を 「2026年_冬」と名付けて作成します。
  2. フォルダIDを取得する
    • 作成した「2026年_冬」フォルダを開き、ブラウザのURLバーを確認します。
    • https://drive.google.com/drive/folders/【ここの英数字の羅列】 の【ここの英数字の羅列】部分がフォルダIDです。これをコピーしておきましょう([第41回]のおさらいですね!)。
  3. テスト用のファイルを用意する
    • マイドライブ(または適当な作業用フォルダ)に、移動テスト用のファイルを用意します。
    • ドキュメントやスプレッドシート、PDFなど何でも構いません。今回は例として 処理済み領収書_札幌オフィス という名前のファイルを作成しておきます。
    • そのファイルの ファイルID もURLバーから取得してコピーしておきます(https://docs.google.com/document/d/【ファイルID】/edit などのID部分)。

3. STEP1:【実践】ファイルを「2026年_冬」フォルダへ自動移動してみよう!

準備ができたら、GASのエディタを開いてコードを書いていきましょう!

1. コードを入力する

スプレッドシートなどの「拡張機能」>「Apps Script」を開くか、スタンドアロンのエディタを開き、以下のコードを貼り付けます。

function moveMyReceiptFile() {
  // 1. 移動したいファイルのIDと、移動先フォルダのIDを設定
  var fileId = "【ここに取得したファイルIDを貼り付け】";
  var targetFolderId = "【ここに取得した『2026年_冬』のフォルダIDを貼り付け】";

  // 2. IDをもとにファイルオブジェクトとフォルダオブジェクトを取得
  var file = DriveApp.getFileById(fileId);
  var targetFolder = DriveApp.getFolderById(targetFolderId);

  // 3. ファイルを目的のフォルダへ移動!
  file.moveTo(targetFolder);

  // 4. 実行ログで結果を確認(第1回で学んだ Logger.log です!)
  Logger.log("ファイル「" + file.getName() + "」を「" + targetFolder.getName() + "」フォルダへ移動しました!");
}

2. コードの1行解説!

  • DriveApp.getFileById(fileId)ファイルIDを使って、Google Driveの中から操作対象のファイルを掴みます。
  • DriveApp.getFolderById(targetFolderId)フォルダIDを使って、移動先の 2026年_冬 フォルダを掴みます。
  • file.moveTo(targetFolder)今回の主役です!掴んだファイルを targetFolder の中へ移動させます。

3. 保存して実行する

  1. エディタ上部の 「保存(フロッピーディスクのアイコン)」 をクリックします。
  2. 関数名が moveMyReceiptFile になっていることを確認し、「実行」 ボタンをクリックします。
  3. (初回実行時はGoogleの承認画面が出ますので、アカウントを選択して許可を出しましょう)。

4. 実行結果を確認してみよう!

Google Driveの画面に戻って確認してみましょう。 マイドライブ等にあった 処理済み領収書_札幌オフィス ファイルが消えて、2026年_冬 フォルダの中にしっかりと移動していれば大成功です!

エディタ下部の実行ログにも、以下のように表示されているはずです。

情報    ファイル「処理済み領収書_札幌オフィス」を「2026年_冬」フォルダへ移動しました!

4. STEP2:実務で差がつく!File.moveTo() の応用パターン3選

単に1つのファイルを移動するだけでなく、実際の業務でよく使う発展的な活用パターンを3つご紹介します。

応用①:[第45回] setName() と組み合わせて「リネーム + 移動」を同時に行う

ファイルを移動させるタイミングで、ファイル名の先頭に日付や「【処理済み】」というステータスを自動付与してリネーム(名前変更)するテクニックです。

function renameAndMoveFile() {
  var file = DriveApp.getFileById("【ファイルID】");
  var targetFolder = DriveApp.getFolderById("【フォルダID】");

  // 1. ファイル名を変更(第45回のおさらい!)
  var oldName = file.getName();
  var newName = "【処理済み】202612_札幌経費_" + oldName;
  file.setName(newName);

  // 2. 指定フォルダへ移動
  file.moveTo(targetFolder);

  Logger.log("リネームして移動完了: " + newName);
}

これで、「名前の整理」と「フォルダ分け」がたった1つのプログラムで一気に完了します!

応用②:フォルダ内のファイルを一括でループ移動する

「受付用フォルダに入っているたくさんの領収書PDFを、すべてまとめて整理用フォルダへ移動したい」という場合は、[第43回]で学んだ Folder.getFiles() と while ループを組み合わせます。

function moveAllReceipts() {
  // 未処理フォルダと処理済みフォルダ(2026年_冬)を取得
  var srcFolder = DriveApp.getFolderById("【未処理フォルダID】");
  var targetFolder = DriveApp.getFolderById("【2026年_冬フォルダID】");

  // 未処理フォルダ内のファイルを一覧取得(第43回)
  var files = srcFolder.getFiles();

  // ファイルが存在する限り繰り返す
  while (files.hasNext()) {
    var file = files.next();
    
    // 順次移動!
    file.moveTo(targetFolder);
    Logger.log("移動完了: " + file.getName());
  }
}

手動で何十枚ものファイルをドラッグ&ドロップしていた作業が、ボタン1つで一瞬で終わるようになりますよ!

応用③:移動先のフォルダが存在しなければ自動作成して移動する

あらかじめフォルダが存在しない場合でも、[第48回]で学ぶ createFolder()(または Folder.createFolder())を使って「今月のフォルダがなければ作って、そこへ移動する」という高度な自動化も可能です。

function moveToMonthlyFolder() {
  var file = DriveApp.getFileById("【ファイルID】");
  
  // 今月用のフォルダ名(例: "2026年_12月")
  var folderName = "2026年_12月";
  
  // マイドライブ直下にフォルダを検索または作成
  var folders = DriveApp.getFoldersByName(folderName);
  var targetFolder;
  
  if (folders.hasNext()) {
    targetFolder = folders.next(); // 既存のフォルダを使う
  } else {
    targetFolder = DriveApp.createFolder(folderName); // 新しく作成!
  }

  // 自動作成された(または取得した)フォルダへ移動
  file.moveTo(targetFolder);
}

5. 初心者が絶対につまずく!4大トラップと完全対処法

File.moveTo() を使う際、プログラミング初心者やGAS学習者が非常によく遭遇するエラーや勘違いを4つ厳選しました。

トラップ1:引数に「フォルダID(文字列)」を直接渡してしまう

一番多い間違いがこちらです。

// ✕ エラーになるNGな書き方(文字列のIDを直接渡している)
file.moveTo("1A2b3C4d5E6f...");

// ◯ 正しい書き方(Folderオブジェクトを渡す)
var targetFolder = DriveApp.getFolderById("1A2b3C4d5E6f...");
file.moveTo(targetFolder);

moveTo() のカッコの中(引数)には、「フォルダIDの文字」ではなく「DriveApp.getFolderById() 等で取得した Folder オブジェクト」 を渡さなければなりません。

文字列のまま渡すと Exception: Invalid argument: destination といったエラーが発生しますので注意しましょう!

トラップ2:インターネット上の古い記事を見て addFolder() を使ってしまう

ネットでGASのファイル移動について検索すると、数年前の古い記事で以下のようなコードが紹介されていることがあります。

// ✕ 古い書き方(現在は非推奨・面倒)
var sourceFolder = DriveApp.getFolderById("...");
targetFolder.addFile(file);
sourceFolder.removeFile(file);

これは旧世代の書き方です。現在は本記事で解説している file.moveTo(targetFolder) たった1行で綺麗に移動できます ので、古い情報に惑わされないようにしてくださいね!

トラップ3:移動させたらファイルのIDが変わってしまうと勘違いする

「ファイルを別のフォルダに移動させたら、ファイルIDも変わっちゃうのかな?」と心配される方がいますが、ファイルを移動してもファイルIDは一切変わりません。

そのため、移動した直後でも同じ file 変数を使って、引き続きリネームしたり権限を変更したりすることができます。

トラップ4:共有ドライブや権限不足によるエラー

自分に編集権限がないフォルダや、共有ドライブの制限によっては、moveTo() を実行した際に権限エラー(Cannot use moveTo() on the specified file... など)が発生することがあります。

操作するファイルや移動先フォルダに対して、自分が 「編集者(管理者)」権限 を持っているか事前に確認しておきましょう。

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

今回は、Google Drive上のファイルを自由自在に自動移動できる File.moveTo() について解説しました!

今日の重要ポイントおさらい

  1. file.moveTo(targetFolder) でファイルを別フォルダへ一瞬で移動できる
  2. 引数には「フォルダIDの文字列」ではなく「Folderオブジェクト」を渡す
  3. [第45回]の setName() や [第43回]のループ処理と組み合わせると一括整理ツールができる
  4. ファイルを移動してもファイルIDは変わらない

ファイル名の変更(第45回)とフォルダ移動(第46回)をマスターしたことで、Google Drive内の自動整理システムがかなり完成形に近づいてきましたね!

さて、不要になった過去のファイルや、テスト作成した一時ファイルが溜まってきたら、次は 「ゴミ箱へ移動して整理する」 ことがしたくなりますよね。

次回(第47回)は、古くなった不要なファイル(例:「一昨年の除雪計画案.docx」など)を自動で安全にゴミ箱へ移動させる File.setTrashed() の使い方を解説します!

Google Driveを常にキレイな状態に保つためのテクニックをお届けしますので、ぜひ楽しみに待っていてくださいね!