【GASスプレッドシート】getRowIndex()で効率的な行番号取得・SEO最適化

/**
 * アクティブなシートのC3セルの行番号を取得し、ログに出力する関数。
 * 結果は「3」となります。
 */
function basicGetRowIndex() {
  const sheet = SpreadsheetApp.getActiveSheet(); // アクティブなシートを取得
  const range = sheet.getRange("C3");           // C3セルをRangeオブジェクトとして取得
  const rowNumber = range.getRowIndex();        // C3セルの行番号を取得

  Logger.log(`C3セルの行番号: ${rowNumber}`); // 結果: 3 が出力される
}

/**
 * シートのデータ範囲の開始行を動的に取得する関数。
 * ヘッダー行を除いてデータ本体の開始行を特定する際などに利用できます。
 */
function getDynamicDataRangeStartRow() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const lastRow = sheet.getLastRow(); // データが入力されている最終行番号を取得

  // 例: ヘッダーが1行目にあるとして、データ本体は2行目から開始すると仮定
  // データ範囲 (2行目から最終行まで) をRangeオブジェクトで表現
  const dataRange = sheet.getRange(2, 1, lastRow - 1, sheet.getLastColumn()); 
  const startRowOfData = dataRange.getRowIndex(); // データ範囲の開始行番号を取得

  Logger.log(`データ範囲の開始行: ${startRowOfData}`); // 例: 2 が出力される
  // ここで取得したstartRowOfDataを用いて、以降のデータ処理を行う
}

/**
 * シートのデータ範囲を一括で二次元配列として取得し、
 * 各データの「スプレッドシート上の実際の行番号」と共にログに出力する関数。
 */
function process2DArrayWithActualRowNumbers() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const dataRange = sheet.getDataRange(); // シート内のデータが存在する全範囲を取得
  const values = dataRange.getValues();   // データ範囲の値を二次元配列として取得
  const rangeStartRow = dataRange.getRowIndex(); // データ範囲の開始行番号を取得
  
  Logger.log(`データ範囲の開始行 (1ベース): ${rangeStartRow}`);

  values.forEach((rowData, indexInArray) => {
    // 二次元配列のインデックス (0ベース) をスプレッドシートの実際の行番号 (1ベース) に変換
    const actualRowNumber = rangeStartRow + indexInArray;
    Logger.log(`実際の行番号: ${actualRowNumber}, 取得データ: ${rowData.join(", ")}`);
    // ここに各行データに対する処理を追加
  });
}

/**
 * A列の値が「完了」である行を検索し、そのスプレッドシート上の行番号をログに出力する関数。
 */
function findRowsByCondition() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const dataRange = sheet.getDataRange(); // シートの全データ範囲を取得
  const values = dataRange.getValues();   // 全データを二次元配列として取得
  const rangeStartRow = dataRange.getRowIndex(); // データ範囲の開始行番号

  Logger.log("「完了」ステータスの行を検索中...");

  values.forEach((rowData, indexInArray) => {
    // A列 (配列インデックス0) の値が「完了」であるかチェック
    if (rowData[0] === "完了") {
      const actualRowNumber = rangeStartRow + indexInArray;
      Logger.log(`「完了」と記載のある行が検出されました: ${actualRowNumber} 行目`);
      // 例えば、この行に対して別の処理（色付け、別のシートへ移動など）を行う
    }
  });
  Logger.log("検索が完了しました。");
}

/**
 * シートや範囲の存在を安全に確認し、getRowIndex()を実行する例。
 */
function safeGetRowIndexExample() {
  const sheetName = "目的のシート名"; // 対象のシート名
  const targetSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheetName);

  if (targetSheet) {
    const rangeA1 = targetSheet.getRange("A1"); // 存在するシートのA1セル
    // スプレッドシートの最大行数を超えない範囲を指定
    if (rangeA1.getMaxRows() >= 1 && rangeA1.getMaxColumns() >= 1) { 
      const rowNumber = rangeA1.getRowIndex();
      Logger.log(`シート「${sheetName}」のA1セルの行番号: ${rowNumber}`);
    } else {
      Logger.log(`シート「${sheetName}」には有効なA1セル範囲がありません。`);
    }
  } else {
    Logger.log(`エラー: シート「${sheetName}」が存在しません。処理をスキップします。`);
  }
}