【GASスプレッドシート】getValue()でセル値を効率的に取得・SEO最適化と注意点

/**
 * アクティブなシートのA1セルの値を取得し、ログに出力する関数。
 */
function getSingleCellValueBasic() {
  const sheet = SpreadsheetApp.getActiveSheet(); // アクティブなシートを取得
  const cell = sheet.getRange("A1");           // A1セルをRangeオブジェクトとして取得
  const value = cell.getValue();                // A1セルの値を取得
  
  Logger.log(`A1セルの値: ${value}`); // 取得した値をログに出力
}

/**
 * 日付として入力されたセルの値を取得し、特定のフォーマットで文字列に変換する関数。
 */
function getAndFormatDateValue() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const dateCell = sheet.getRange("C3"); // 例: C3に「2025/03/05」が入力されていると仮定
  const dateValue = dateCell.getValue();  // Dateオブジェクトとして取得

  if (dateValue instanceof Date) { // 取得した値がDateオブジェクトであることを確認
    // Dateオブジェクトを「YYYY/MM/DD」形式の文字列に変換
    const formattedDate = Utilities.formatDate(dateValue, Session.getScriptTimeZone(), "yyyy/MM/dd");
    Logger.log(`C3セルのフォーマット後の日付: ${formattedDate}`);
  } else {
    Logger.log(`C3セルは日付ではありませんでした: ${dateValue}`);
  }
}

/**
 * 複数範囲のセルの値をgetValues()で一括取得し、ログに出力する関数。
 */
function getMultipleValuesEfficiently() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1:C10"); // 対象範囲をA1:C10に設定
  const values = range.getValues();       // 範囲内の全セルの値を二次元配列として一括取得

  Logger.log(`A1:C10範囲の取得値:\n${JSON.stringify(values, null, 2)}`);

  // 取得した二次元配列をループ処理
  values.forEach((rowValues, rowIndex) => {
    rowValues.forEach((cellValue, colIndex) => {
      // スプレッドシート上のA1表記を計算
      const cellAddress = sheet.getRange(rowIndex + 1, colIndex + 1).getA1Notation();
      Logger.log(`セル ${cellAddress} の値: ${cellValue}`);
    });
  });
}

/**
 * 範囲内の値が特定の閾値（例: 100）を超えるセルを赤色にハイライトする関数。
 */
function highlightCellsBasedOnValue() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const dataRange = sheet.getRange("A1:C10"); // 処理対象範囲
  const values = dataRange.getValues();       // セルの値を一括取得
  
  const rules = sheet.getConditionalFormatRules(); // 既存の条件付き書式ルールを取得
  const newRules = []; // 新しいルールを格納する配列

  values.forEach((rowValues, rowIndex) => {
    rowValues.forEach((cellValue, colIndex) => {
      if (typeof cellValue === 'number' && cellValue > 100) { // 数値が100を超える場合
        // 該当セルに赤色の背景色を設定する条件付き書式ルールを構築
        const targetRange = sheet.getRange(dataRange.getRow() + rowIndex, dataRange.getColumn() + colIndex);
        const rule = SpreadsheetApp.newConditionalFormatRule()
          .whenNumberGreaterThan(100)
          .setBackground("#FFCCCC") // 薄い赤色に設定
          .setRanges([targetRange])
          .build();
        newRules.push(rule);
      }
    });
  });

  // 既存ルールに新しいルールを追加して更新
  sheet.setConditionalFormatRules([...rules, ...newRules]);
  Logger.log("値に基づいてセルをハイライトする条件付き書式を追加しました。");
}

// const sheet = SpreadsheetApp.getActiveSheet();
// for (let i = 1; i <= 100; i++) {
//   const value = sheet.getRange("A" + i).getValue(); // ループごとにAPI呼び出しが発生
//   Logger.log(value);
// }
// -> 100回のAPI呼び出しが発生し、非常に遅くなります。

/**
 * ループ内でgetValue()を呼び出す代わりに、getValues()で一括取得する効率的な方法。
 */
function processValuesEfficiently() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1:A100"); // 100個のセル範囲
  const values = range.getValues();       // 一度のAPI呼び出しで全値を取得
  
  values.forEach(row => { // valuesは二次元配列なので、各rowも配列になる
    row.forEach(cellValue => {
      Logger.log(cellValue);
    });
  });
  Logger.log("セル値を効率的に処理しました。");
}

/**
 * 存在しないセル範囲へのアクセスによるエラーをtry...catchで捕捉する関数。
 */
function safeGetValueExample() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const invalidCellAddress = "Z10000000"; // 存在しない可能性のあるセルアドレス

  try {
    const value = sheet.getRange(invalidCellAddress).getValue();
    Logger.log(`セル ${invalidCellAddress} の値: ${value}`);
  } catch (e) {
    Logger.error(`エラーが発生しました: セル ${invalidCellAddress} へのアクセスに失敗。メッセージ: ${e.message}`);
    // ユーザーに通知するUI要素を表示することも可能
    // SpreadsheetApp.getUi().alert('エラー', `無効なセル範囲: ${invalidCellAddress}`, SpreadsheetApp.getUi().ButtonSet.OK);
  }
}