GASでフィルターを自動操作！getFilter()でデータ絞り込みを効率化する方法

function checkFilterExists() {
  const sheet = SpreadsheetApp.getActiveSheet();
  // シートに設定されているフィルターを取得
  const filter = sheet.getFilter();

  if (filter) {
    const rangeA1 = filter.getRange().getA1Notation();
    console.log(`このシートにはフィルターが適用されています。範囲: ${rangeA1}`);
  } else {
    console.log("このシートにフィルターは適用されていません。");
  }
}

function refreshFilterRange() {
  const sheet = SpreadsheetApp.getActiveSheet();
  // 最新のデータ範囲を取得 (例: A1からデータがある最後のセルまで)
  const dataRange = sheet.getDataRange();
  
  // 既存のフィルターが存在すれば、まず削除する
  const currentFilter = sheet.getFilter();
  if (currentFilter) {
    currentFilter.remove();
  }

  // 最新のデータ範囲に対して新しいフィルターを作成
  dataRange.createFilter();
  console.log(`フィルターを範囲 ${dataRange.getA1Notation()} で更新しました。`);
}

function applyDynamicFilter() {
  const sheet = SpreadsheetApp.getActiveSheet();
  
  // シートのフィルターを取得。なければデータ範囲全体に新規作成する
  const filter = sheet.getFilter() || sheet.getDataRange().createFilter();

  // 絞り込み条件（FilterCriteria）を作成
  const criteria = SpreadsheetApp.newFilterCriteria()
    .whenTextContains("重要") // テキストに「重要」が含まれる
    .build();

  // 1列目（A列）にフィルター条件をセット
  // この命令で、実際のシート上の表示が絞り込まれる
  filter.setColumnFilterCriteria(1, criteria);
  
  console.log("1列目を「重要」で絞り込みました。");
}

function clearAllFilterCriteria() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const filter = sheet.getFilter();

  if (filter) {
    const range = filter.getRange();
    // フィルター範囲のすべての列に対してループ
    for (let i = 1; i <= range.getNumColumns(); i++) {
      // 各列の絞り込み条件を削除
      filter.removeColumnFilterCriteria(i);
    }
    console.log("すべてのフィルター条件をクリアしました。");
  }
}