GASでGoogleドライブの
ファイル・フォルダを一覧・検索する方法

function listFilesInFolder(folderId) {
  // フォルダIDはドライブでフォルダを開いたときのURL末尾の文字列
  const folder = DriveApp.getFolderById(folderId);
  const files = folder.getFiles(); // FileIterator（配列ではない）

  while (files.hasNext()) {
    const file = files.next();
    Logger.log(
      file.getName() + " / " + file.getUrl()
    );
  }
}

function listPdfFiles(folderId) {
  const folder = DriveApp.getFolderById(folderId);
  // 種類で絞る: PDFだけ取得
  const files = folder.getFilesByType(MimeType.PDF);

  const result = [];
  while (files.hasNext()) {
    const file = files.next();
    result.push(file.getName());
  }

  // 名前で探すときは getFilesByName("請求書.pdf") も使える
  Logger.log("PDF: " + result.length + "件");
  return result;
}

function searchInvoices(folderId) {
  const folder = DriveApp.getFolderById(folderId);

  // 検索クエリ = Googleドライブの検索構文
  //   title contains '...'   … ファイル名に含む
  //   mimeType = '...'        … 種類
  //   and / or で条件を組み合わせる
  const query =
    "title contains '請求書' and mimeType = 'application/pdf'";
  const files = folder.searchFiles(query);

  while (files.hasNext()) {
    const file = files.next();
    Logger.log(file.getName());
  }
}

function listAllFiles(folderId) {
  const folder = DriveApp.getFolderById(folderId);
  const rows = [];
  collect(folder, rows);
  Logger.log("合計 " + rows.length + " ファイル");
  return rows;
}

// フォルダを再帰的にたどって全ファイルを集める
function collect(folder, rows) {
  const files = folder.getFiles();
  while (files.hasNext()) {
    const file = files.next();
    rows.push([file.getName(), file.getUrl(), folder.getName()]);
  }

  // 直下のサブフォルダを取得し、同じ処理を繰り返す
  const subFolders = folder.getFolders();
  while (subFolders.hasNext()) {
    collect(subFolders.next(), rows);
  }
}

function listRecentFiles(folderId) {
  const folder = DriveApp.getFolderById(folderId);

  // 30日前の日付を ISO形式（yyyy-MM-dd）で作る
  const since = new Date();
  since.setDate(since.getDate() - 30);
  const isoDate = Utilities.formatDate(
    since, "Asia/Tokyo", "yyyy-MM-dd"
  );

  // modifiedDate > '日付' で更新日が新しいものだけに絞る
  const query = "modifiedDate > '" + isoDate + "'";
  const files = folder.searchFiles(query);

  while (files.hasNext()) {
    const file = files.next();
    // getSize() はバイト単位。1024で割ってKB表示にする
    const kb = Math.round(file.getSize() / 1024);
    Logger.log(
      file.getName() + " / " +
      Utilities.formatDate(
        file.getLastUpdated(), "Asia/Tokyo", "yyyy/MM/dd"
      ) + " / " + kb + "KB"
    );
  }
}

function exportFileListToSheet(folderId) {
  const sheet = SpreadsheetApp.getActiveSheet();
  const folder = DriveApp.getFolderById(folderId);
  const files = folder.getFiles();

  const rows = [["ファイル名", "種類", "更新日", "サイズ(KB)", "URL"]];
  while (files.hasNext()) {
    const file = files.next();
    rows.push([
      file.getName(),
      file.getMimeType(),
      Utilities.formatDate(
        file.getLastUpdated(), "Asia/Tokyo", "yyyy/MM/dd"
      ),
      Math.round(file.getSize() / 1024),
      file.getUrl(),
    ]);
  }

  // 1件ずつ書くと遅い。二次元配列で一括書き込みする
  sheet.clearContents();
  sheet.getRange(1, 1, rows.length, rows[0].length).setValues(rows);
}