GASでスプレッドシートの行・列を
グループ化して折りたたむ方法

function groupRows() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("売上");

  // 2行目から10行目（9行分）をひとつのグループにする
  // "2:10" は行全体を指すA1表記
  sheet.getRange("2:10").shiftRowGroupDepth(1);
}

function groupRowsNested() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("売上");

  // 大グループ: 2〜11行目
  sheet.getRange("2:11").shiftRowGroupDepth(1);

  // その中の小グループ: 3〜6行目（もう1段深くする）
  sheet.getRange("3:6").shiftRowGroupDepth(1);

  // 何段目のグループに属するかを確認
  Logger.log(sheet.getRowGroupDepth(4)); // → 2
}

// シート全体のグループをまとめて折りたたむ／展開する
function collapseAllRows() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("売上");
  sheet.collapseAllRowGroups();
}

function expandAllRows() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("売上");
  sheet.expandAllRowGroups();
}

// 特定の1グループだけ折りたたむ
function collapseOneGroup() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("売上");

  // 「3行目を含む、深さ1のグループ」を取得
  const group = sheet.getRowGroup(3, 1);
  group.collapse();          // 折りたたむ（expand()で展開）
}

function groupColumns() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("売上");

  // C〜E列（3列目から3列分）をグループ化する
  // 行数はシート全体（getMaxRows）を指定
  sheet.getRange(1, 3, sheet.getMaxRows(), 3).shiftColumnGroupDepth(1);

  // まとめて開閉するメソッドも用意されている
  sheet.collapseAllColumnGroups();  // 全列グループを折りたたむ
  sheet.expandAllColumnGroups();    // 全列グループを展開する
}

function setControlPosition() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("売上");

  // 折りたたみボタンをグループの「下側」に表示する
  // 小計・合計をグループの下にまとめるレイアウト向き
  sheet.setRowGroupControlAfter(true);

  // 現在の設定を確認（true = 後ろ側 / false = 前側）
  Logger.log(sheet.getRowGroupControlPosition());
}

// A列のカテゴリが同じ行を、カテゴリごとに自動でグループ化する
// （事前にカテゴリ列で並べ替えておくこと）
function autoGroupByCategory() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("売上");
  const lastRow = sheet.getLastRow();
  if (lastRow < 3) return;

  // 2行目以降のA列（カテゴリ）を一括取得
  const categories = sheet
    .getRange(2, 1, lastRow - 1, 1)
    .getValues()
    .map((row) => row[0]);

  clearRowGroups(sheet); // 既存グループをいったんリセット

  let blockStart = 0; // categories配列上のブロック先頭インデックス
  for (let i = 1; i <= categories.length; i++) {
    const isBoundary =
      i === categories.length || categories[i] !== categories[blockStart];

    if (isBoundary) {
      const startRow = blockStart + 2; // 実際の行番号（ヘッダー分+1）
      const count = i - blockStart;    // 同じカテゴリの行数
      if (count >= 1) {
        sheet.getRange(startRow, 1, count, 1).shiftRowGroupDepth(1);
      }
      blockStart = i;
    }
  }
}

// シート内の行グループをすべて解除する
function clearRowGroups(sheet) {
  const maxRows = sheet.getMaxRows();
  for (let row = 1; row <= maxRows; row++) {
    const depth = sheet.getRowGroupDepth(row);
    if (depth > 0) {
      // 深さの数だけまとめて解除する
      sheet.getRange(row, 1, 1, 1).shiftRowGroupDepth(-depth);
    }
  }
}

// 範囲を指定して1段だけ解除する例
function ungroupRange() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("売上");
  sheet.getRange("3:6").shiftRowGroupDepth(-1);
}