【GAS高速化】getFontFamilies()でAPI呼び出しを1回に！スプレッドシートのフォント取得が遅い問題を解決

// 【非推奨】1000回のAPI呼び出しが発生する遅いコード
function slowFontCheck() {
  const range = SpreadsheetApp.getActiveSheet().getRange("A1:E200"); // 1000セル
  const fonts = [];
  for (let r = 1; r <= 200; r++) {
    for (let c = 1; c <= 5; c++) {
      // ループのたびにAPIを呼び出すため、極端に遅くなる
      const font = range.getCell(r, c).getFontFamily();
      fonts.push(font);
    }
  }
}

// 【推奨】API呼び出しはたった1回！劇的に速いコード
function fastFontCheck() {
  const range = SpreadsheetApp.getActiveSheet().getRange("A1:E200");
  // API呼び出しはここでの1回だけ！
  const fontFamilies = range.getFontFamilies();
  
  // 取得した二次元配列を後から自由に処理できる
  console.log(fontFamilies); 
}

function fetchAllFonts() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1:B3");
  const fontMatrix = range.getFontFamilies();

  // 取得した二次元配列をループで処理
  fontMatrix.forEach((row, rowIndex) => {
    row.forEach((font, colIndex) => {
      const cellAddress = range.getCell(rowIndex + 1, colIndex + 1).getA1Notation();
      console.log(`セル ${cellAddress} のフォントは「${font}」です。`);
    });
  });
}

function auditFontCompliance() {
  const ALLOWED_FONTS = ['Arial', 'メイリオ', 'Times New Roman']; // 許可フォントのリスト
  
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getDataRange();

  // フォントと背景色をそれぞれ一括取得
  const fonts = range.getFontFamilies();
  const backgrounds = range.getBackgrounds();

  fonts.forEach((row, r) => {
    row.forEach((font, c) => {
      // 許可リストに含まれていないフォントかチェック
      if (!ALLOWED_FONTS.includes(font)) {
        backgrounds[r][c] = '#f4cccc'; // 背景を薄い赤に変更
      }
    });
  });

  // 変更した背景色の配列をまとめて一括書き込み
  range.setBackgrounds(backgrounds);
}

function createFontUsageReport() {
  const sheet = SpreadsheetApp.getActiveSheet();
  // flat()で二次元配列を一次元配列に変換
  const fonts = sheet.getDataRange().getFontFamilies().flat(); 
  const fontStats = {};

  // フォントごとの使用回数を集計
  fonts.forEach(font => {
    fontStats[font] = (fontStats[font] || 0) + 1;
  });

  // 新しいシートを作成してレポートを出力
  const reportSheet = SpreadsheetApp.getActive().insertSheet('FontUsageReport_' + new Date().getTime());
  reportSheet.appendRow(['フォント名', '使用セル数']);
  
  // 使用回数の多い順にソートして出力
  const sortedData = Object.entries(fontStats).sort((a, b) => b[1] - a[1]);
  
  if (sortedData.length > 0) {
    reportSheet.getRange(2, 1, sortedData.length, 2).setValues(sortedData);
  }
}