【GASスプレッドシート】getRow()で正確な行番号取得！自動化とSEO最適化

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

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

/**
 * 現在選択されているセルの開始行番号を取得し、ログに出力する関数。
 * 選択範囲が複数行にわたる場合でも、その範囲の最初の行番号が取得されます。
 */
function logActiveCellRow() {
  const activeCell = SpreadsheetApp.getActiveRange(); // 現在アクティブなRangeオブジェクトを取得
  Logger.log(`現在選択中のセルの開始行番号: ${activeCell.getRow()}`);
}

/**
 * シートの2行目からデータの最終行までをループ処理し、各行のA列のデータをログに出力する関数。
 * データの増減に自動で対応します。
 */
function processAllDataRowsDynamically() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const lastRow = sheet.getLastRow(); // データが入力されている最終行番号を取得
  
  Logger.log(`シートの最終データ行: ${lastRow}`);

  // ヘッダー行を除き、2行目から最終行までループ処理
  for (let i = 2; i <= lastRow; i++) {
    const value = sheet.getRange(i, 1).getValue(); // i行目のA列の値を取得
    Logger.log(`行番号: ${i}, A列データ: ${value}`);
    // ここに各行に対する処理を追加
  }
}

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

  values.forEach((rowData, indexInArray) => {
    // スプレッドシート上の実際の行番号を計算
    const actualRowNumber = startRow + indexInArray;
    Logger.log(`実際の行番号: ${actualRowNumber}, データ: ${rowData.join(", ")}`);
    // ここに各行データに対する処理を追加
  });
}

/**
 * スプレッドシートが開かれた時にカスタムメニューを追加する関数。
 * GASトリガーの「onOpen」イベントで自動実行されます。
 */
function onOpen() {
  SpreadsheetApp.getUi().createMenu('カスタム機能') // 「カスタム機能」というメニューを作成
    .addItem('現在の行番号を表示', 'showRowNumberDialog') // メニュー項目とその実行関数を設定
    .addToUi(); // UIに追加
}

/**
 * 現在選択されているセルの行番号をダイアログで表示する関数。
 */
function showRowNumberDialog() {
  const selection = SpreadsheetApp.getActiveRange(); // 現在の選択範囲を取得
  if (selection) {
    const row = selection.getRow(); // 選択範囲の開始行番号を取得
    SpreadsheetApp.getUi().alert(`現在選択中の範囲の開始行は ${row} 行目です。`);
  } else {
    SpreadsheetApp.getUi().alert('セルが選択されていません。');
  }
}

/**
 * アクティブな行のデータを取得し、その行番号と共に外部APIに送信する関数。
 * 例として、行番号をデータの識別子として利用します。
 */
function exportActiveRowDataToApi() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const activeRange = sheet.getActiveRange(); // 現在アクティブな範囲を取得
  const rowNumber = activeRange.getRow();   // アクティブな範囲の開始行番号を取得
  
  // アクティブな行のA列からE列までのデータ（1行5列）を取得
  const rowData = sheet.getRange(rowNumber, 1, 1, 5).getValues()[0];
  
  // 外部APIに送信するペイロードを構築
  const payload = {
    spreadsheetRowId: rowNumber, // 行番号をデータのユニークIDとして利用
    data: rowData,
    exportedAt: new Date().toISOString()
  };
  
  const options = {
    method: 'post',
    contentType: 'application/json',
    payload: JSON.stringify(payload),
    muteHttpExceptions: true // エラー時に例外をスローしない
  };
  
  try {
    const response = UrlFetchApp.fetch('https://api.example.com/data/update', options);
    Logger.log(`API応答: ${response.getResponseCode()} - ${response.getContentText()}`);
  } catch (e) {
    Logger.log(`API呼び出しエラー: ${e.message}`);
  }
}