公開日：2026/09/12 19:37 最終更新日：2026/09/14 16:22

Driveの重複候補を削除前に発見｜GASでファイル名・種類・サイズをdry-run監査

Xでシェア facebookでシェア LINEでシェア

ツールおじ｜GoogleアカウントをAIエージェント化

先に知っておきたいこと
準備するテスト用フォルダ
コピーして使える最小コード
実行前の準備
ログの読み方
削除前のチェックリスト
停止条件
制限と安全上の注意
まとめ

Google Driveを整理するとき、同じ名前のファイルを見つけても、すぐ削除するのは危険です。名前が同じでも内容が違う場合があり、共有中のファイルを消すと業務へ影響するためです。

この記事では、指定したテスト用フォルダだけを読み取り、ファイル名・種類・サイズが一致する組み合わせを「重複候補」として数えるGASを紹介します。削除、移動、名前変更、共有設定の変更は行いません。

先に知っておきたいこと

対象は、コードに指定した1つのフォルダ直下だけです。サブフォルダは走査しません。
初期設定では最大500件まで確認し、上限を超えたら処理を止めます。
ファイル名・MIMEタイプ・サイズの一致だけでは、内容が完全に同じとは断定できません。
Googleドキュメント、スプレッドシート、スライドなど、サイズを取得できないファイルは誤判定防止のため除外します。
初期設定ではファイル名やIDをログへ出さず、候補グループ数と件数だけを表示します。
このコードは候補抽出専用です。削除や移動は人が内容と共有状況を確認したあとに判断してください。

準備するテスト用フォルダ

まず、個人情報や機密情報を含まない検証用フォルダを用意します。

同じ名前・種類・サイズのテストファイルを2件
名前は同じでもサイズが違うテストファイルを1件
通常の別ファイルを1件

フォルダURLのfolders/以降にある文字列を、コードのFOLDER_IDへ設定します。共有ドライブや業務フォルダ全体ではなく、少量の検証用フォルダから始めてください。

コピーして使える最小コード

function auditDriveDuplicateCandidatesFree() {
  const CONFIG = {
    DRY_RUN: true,
    FOLDER_ID: 'YOUR_TEST_FOLDER_ID',
    MAX_FILES: 500,
    LOG_FILE_NAMES: false
  };

  if (CONFIG.DRY_RUN !== true) {
    throw new Error('この無料例はDRY_RUN=trueのまま使用してください。');
  }
  if (!/^[A-Za-z0-9_-]{10,}$/.test(CONFIG.FOLDER_ID) || CONFIG.FOLDER_ID === 'YOUR_TEST_FOLDER_ID') {
    throw new Error('検証用フォルダのIDを設定してください。');
  }

  const folder = DriveApp.getFolderById(CONFIG.FOLDER_ID);
  const files = folder.getFiles();
  const groups = {};
  let checkedFiles = 0;
  let skippedGoogleFiles = 0;

  while (files.hasNext()) {
    const file = files.next();
    checkedFiles += 1;
    if (checkedFiles > CONFIG.MAX_FILES) {
      throw new Error('確認上限を超えました。対象フォルダを分けて再実行してください。');
    }

    const size = file.getSize();
    if (!Number.isFinite(size) || size <= 0) {
      skippedGoogleFiles += 1;
      continue;
    }

    const normalizedName = file.getName().normalize('NFKC').trim().toLowerCase();
    const mimeType = file.getMimeType();
    const key = [normalizedName, mimeType, String(size)].join('\u001f');
    if (!groups[key]) groups[key] = [];
    groups[key].push({
      name: file.getName(),
      mimeType: mimeType,
      sizeBytes: size
    });
  }

  const duplicateGroups = Object.keys(groups)
    .map(function (key) {
      return groups[key];
    })
    .filter(function (group) {
      return group.length > 1;
    });

  const result = {
    dryRun: true,
    checkedFiles: checkedFiles,
    skippedGoogleFiles: skippedGoogleFiles,
    duplicateGroupCount: duplicateGroups.length,
    duplicateCandidateCount: duplicateGroups.reduce(function (sum, group) {
      return sum + group.length;
    }, 0)
  };

  if (CONFIG.LOG_FILE_NAMES) {
    result.candidates = duplicateGroups.slice(0, 20);
    result.truncated = duplicateGroups.length > 20;
  }

  console.log(JSON.stringify(result));
  return result;
}