【GAS】getDataRegion()で連続したデータ範囲を自動取得する方法

function basicUsage() {
  const sheet = SpreadsheetApp.getActiveSheet();
  // 表の中のどこか一つのセルを指定
  const startingCell = sheet.getRange('B2');
  
  // B2セルを含むデータ範囲（データブロック）を取得
  const dataRange = startingCell.getDataRegion();
  
  // 取得した範囲のA1表記をログに出力
  console.log(dataRange.getA1Notation()); // 例: "A1:D50"
}

function processDynamicTable() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const headerCell = sheet.getRange('A1');
  
  // A1セルを基点にデータ範囲全体を取得
  const wholeTable = headerCell.getDataRegion();
  
  // offset(1, 0) で1行下にずらし、ヘッダーを除外
  // getNumRows() - 1 でヘッダー分の1行を引く
  const dataBodyRange = wholeTable.offset(1, 0, wholeTable.getNumRows() - 1);

  console.log(`処理対象のデータ本体: ${dataBodyRange.getA1Notation()}`);
  
  const salesData = dataBodyRange.getValues();
  // これ以降で salesData に対する処理を行う
}

function getDimensionSpecificRegion() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const baseCell = sheet.getRange('C5');
  
  // C5セルを基点に、上下に連続するデータ範囲（C列の部分のみ）を取得
  const columnRegion = baseCell.getDataRegion(SpreadsheetApp.Dimension.COLUMNS);
  console.log(`列方向の範囲: ${columnRegion.getA1Notation()}`);
  
  // C5セルを基点に、左右に連続するデータ範囲（5行目の部分のみ）を取得
  const rowRegion = baseCell.getDataRegion(SpreadsheetApp.Dimension.ROWS);
  console.log(`行方向の範囲: ${rowRegion.getA1Notation()}`);
}

const cell = sheet.getRange("A1");
if (cell.isBlank()) {
  console.log("基点セルが空です。処理を中断します。");
  return;
}
const dataRegion = cell.getDataRegion();
// ...