公開日：2026/08/28 19:05 最終更新日：2026/08/31 16:19

共有フォルダの整理漏れを移動前に発見｜GASで直下データをdry-run棚卸し

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

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

先に知っておきたいこと
準備するシート
コピーして使える最小コード
実行手順
失敗しやすい点と停止条件
公開前チェックリスト
まとめ

共有フォルダを整理しようとしても、「同名ファイルがある」「古い資料が残っている」「何を移動すべきか判断できない」と、作業前の確認だけで時間がかかります。この記事では、指定フォルダの直下だけを読み取り、ファイル名・種類・更新日と同名候補を確認用シートへ出す無料のGAS例を紹介します。ファイルの移動・削除・共有設定変更は行いません。

先に知っておきたいこと

対象は指定した1フォルダの直下だけです。子フォルダ内部は再帰走査しません。
`DRY_RUN = true` を固定し、元ファイルや共有権限を変更しません。
閲覧権限のないファイルは取得できません。共有ドライブでは管理者設定や権限により一部情報を取得できない場合があります。
ファイルIDやメールアドレスはシートへ出しません。

準備するシート

スプレッドシートに `Config` と `AuditLog` の2枚を作ります。`Config` シートのA1に `folderId`、B1に監査対象フォルダのIDを入力してください。最初は実データではなく、少量の検証用フォルダで試します。

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

const DRY_RUN = true;

function auditSharedFolderInventoryFree() {
  if (DRY_RUN !== true) throw new Error('安全のためDRY_RUN=trueで実行してください');

  const ss = SpreadsheetApp.getActive();
  const config = ss.getSheetByName('Config');
  const log = ss.getSheetByName('AuditLog') || ss.insertSheet('AuditLog');
  if (!config) throw new Error('Configシートがありません');

  const folderId = String(config.getRange('B1').getValue()).trim();
  if (!/^[A-Za-z0-9_-]{10,}$/.test(folderId)) {
    throw new Error('B1のフォルダIDを確認してください');
  }

  const folder = DriveApp.getFolderById(folderId);
  const rows = [];
  const nameCounts = {};
  const files = folder.getFiles();

  while (files.hasNext()) {
    const file = files.next();
    const name = file.getName();
    nameCounts[name] = (nameCounts[name] || 0) + 1;
    rows.push([
      'FILE',
      name,
      file.getMimeType(),
      file.getLastUpdated(),
      ''
    ]);
    if (rows.length > 500) throw new Error('501件以上です。対象を小さく分けてください');
  }

  const folders = folder.getFolders();
  while (folders.hasNext()) {
    const child = folders.next();
    const name = child.getName();
    nameCounts[name] = (nameCounts[name] || 0) + 1;
    rows.push(['FOLDER', name, '', child.getLastUpdated(), '']);
    if (rows.length > 500) throw new Error('501件以上です。対象を小さく分けてください');
  }

  const output = rows.map(row => {
    row[4] = nameCounts[row[1]] > 1 ? '同名候補' : '確認済み';
    return row;
  });

  log.clearContents();
  log.getRange(1, 1, 1, 5).setValues([['種別', '名前', 'MIMEタイプ', '更新日時', '判定']]);
  if (output.length) log.getRange(2, 1, output.length, 5).setValues(output);
  console.log(JSON.stringify({ folderName: folder.getName(), count: output.length, dryRun: DRY_RUN }));
}