Googleドライブ│フォルダ内のファイル名を一括リネーム！文字列を置換して自動変更する方法

2025年5月29日2026年10月2日

フォルダー直下のファイル名を一括で置換するには、変更前の名前とIDを保存し、置換結果を先に確認します。

この記事のGASは子フォルダーへ入らず、ファイル名だけを変更します。

本文やファイルの保存先は変更しません。

実際の業務フォルダーを使う前に、専用の練習フォルダーで確認してください。

入力例と置換後の名前

変更前	最初の1箇所を置換	すべてを置換
sample_sample.txt	サンプル_sample.txt	サンプル_サンプル.txt
sample.txt	サンプル.txt	サンプル.txt
notes.txt	notes.txt：変更しない	notes.txt：変更しない

RENAME_ALLがfalseなら最初の1箇所だけ、trueならすべての同じ文字列を置換します。

正規表現ではなく文字列を使う例です。

拡張子も名前の一部なので、置換前の文字列が拡張子に含まれる場合は結果を確認してください。

sample_sample.txtの最初のsampleだけがサンプルへ変わり子フォルダーは残っている — 名前変更の実画面。専用ファイルをDrive APIで変更し、同じIDのまま元の名前へ戻せることも確認しました。掲載GASの実行画面ではありません。

プレビューと変更を分けたGASコード

新規のApps Scriptプロジェクトに貼り付け、RENAME_FOLDER_IDを練習用フォルダーのURLにあるIDへ置き換えます。

RENAME_FROMとRENAME_TOは置換前・置換後の文字列です。

処理対象は直下50ファイル以内で、置換後の同名衝突、空の検索文字列、空の結果名を事前に止めます。

const RENAME_FOLDER_ID = '練習用フォルダーのID';
const RENAME_FROM = 'sample';
const RENAME_TO = 'サンプル';
const RENAME_ALL = false; // false: 最初の1箇所、true: すべて
const RENAME_PLAN_KEY = 'cgmRenamePlanV1';

function collectRenamePlan_() {
  if (!RENAME_FROM) throw new Error('置換前の文字列を空にしないでください');
  const folder = DriveApp.getFolderById(RENAME_FOLDER_ID);
  const iterator = folder.getFiles(); // 直下のファイルだけ
  const files = [];
  while (iterator.hasNext()) {
    if (files.length >= 50) throw new Error('練習対象は50ファイル以内です');
    const file = iterator.next();
    const before = file.getName();
    const after = RENAME_ALL ? before.split(RENAME_FROM).join(RENAME_TO)
      : before.replace(RENAME_FROM, () => RENAME_TO);
    if (!after.trim()) throw new Error('空の名前になるファイルがあります');
    files.push({ id: file.getId(), before, after });
  }
  const names = files.map(item => item.after);
  if (new Set(names).size !== names.length) {
    throw new Error('置換後の名前が重複します。変更前に整理してください');
  }
  return { folderId: RENAME_FOLDER_ID, files };
}

function previewRename() {
  const plan = collectRenamePlan_();
  const json = JSON.stringify(plan);
  if (Utilities.newBlob(json).getBytes().length > 8000) {
    throw new Error('保存する計画が大きすぎます。対象を減らしてください');
  }
  PropertiesService.getScriptProperties().setProperty(RENAME_PLAN_KEY, json);
  console.log(JSON.stringify(plan, null, 2)); // 変更前の名前・IDを保存する
  return plan;
}

function applyRename() {
  const saved = PropertiesService.getScriptProperties().getProperty(RENAME_PLAN_KEY);
  if (!saved) throw new Error('先にpreviewRenameを実行してください');
  const plan = JSON.parse(saved);
  const fresh = collectRenamePlan_();
  const ordered = value => JSON.stringify(value.files.slice().sort((a,b) => a.id.localeCompare(b.id)));
  if (plan.folderId !== fresh.folderId || ordered(plan) !== ordered(fresh)) {
    throw new Error('プレビュー後に対象・名前・設定が変わりました。変更はしていません');
  }
  const done = [];
  try {
    for (const item of plan.files) {
      if (item.before === item.after) continue;
      DriveApp.getFileById(item.id).setName(item.after);
      done.push(item.id);
    }
  } catch (error) {
    console.log(JSON.stringify({ doneIds: done, error: String(error) }));
    throw error; // 自動で再実行しない。保存済み計画で変更済みIDを確認する
  }
  console.log(JSON.stringify({ changed: done.length, doneIds: done }));
}