【GASスプレッドシート】getVerticalAlignments()で複数セルの垂直配置を一括取得・SEO最適化

/**
 * アクティブなシートのA1:C3範囲の全セルの垂直配置を二次元配列として一括取得し、ログに出力する関数。
 */
function getAndLogAllVerticalAlignments() {
  const sheet = SpreadsheetApp.getActiveSheet(); // アクティブなシートを取得
  const range = sheet.getRange("A1:C3");      // 対象範囲をA1:C3に設定
  
  // 指定範囲の各セルの垂直配置を二次元配列として一括取得
  const alignments = range.getVerticalAlignments();

  // 取得した二次元配列の内容をJSON形式でログに出力 (視認性のため整形)
  Logger.log(`A1:C3範囲の垂直配置:\n${JSON.stringify(alignments, null, 2)}`);
  /* 例: alignments の出力形式
   * [
   *   ["top", "middle", "bottom"],
   *   ["bottom", "top", "middle"],
   *   ["middle", "bottom", "top"]
   */

  // 各セルのアドレスと共に垂直配置を出力する例
  alignments.forEach((rowAlignments, rowIndex) => {
    rowAlignments.forEach((alignment, colIndex) => {
      // getCell(row, column) は1から始まるインデックス
      const cellAddress = range.getCell(rowIndex + 1, colIndex + 1).getA1Notation();
      Logger.log(`セル ${cellAddress}: 垂直配置 "${alignment}"`);
    });
  });
}

/**
 * A1からC3の範囲のすべてのセルの垂直配置を「中央揃え」に設定する関数。
 */
function setRangeVerticalAlignmentExample() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1:C3");
  range.setVerticalAlignment("middle"); // 全セルを中央揃えに設定
  Logger.log(`A1:C3範囲の垂直配置を「中央揃え」に設定しました。`);
}

/**
 * A1からC3範囲の各セルに異なる垂直配置を一括で設定する関数。
 */
function setMultipleVerticalAlignmentsExample() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1:C3");
  // 設定したい垂直配置を二次元配列で定義
  const alignments = [
    ["top", "middle", "bottom"],   // A1, B1, C1
    ["bottom", "middle", "top"],   // A2, B2, C2
    ["middle", "top", "bottom"]    // A3, B3, C3
  ];
  range.setVerticalAlignments(alignments); // 垂直配置を一括設定
  Logger.log(`A1:C3範囲の各セルに異なる垂直配置を設定しました。`);
}

/**
 * セルの内容のテキスト長に応じて、垂直配置を自動調整する関数。
 * テキスト長が50文字を超えるセルは「上寄せ」、それ以外は「中央揃え」に設定します。
 */
function autoAdjustVerticalAlignmentBasedOnContent() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const dataRange = sheet.getDataRange(); // シート内のデータが存在する全範囲を取得
  const values = dataRange.getValues();   // 全範囲のセル値を取得（テキスト長取得用）
  const newAlignments = [];               // 新しい垂直配置を格納する二次元配列

  values.forEach(rowValues => {
    const rowAlignments = [];
    rowValues.forEach(cellValue => {
      // セル値のテキスト長に基づいて垂直配置を決定
      if (String(cellValue).length > 50) { // 例: 50文字を超える場合
        rowAlignments.push("top");       // 上寄せ
      } else {
        rowAlignments.push("middle");    // 中央揃え
      }
    });
    newAlignments.push(rowAlignments);
  });
  
  // 生成した新しい垂直配置を一括でシートに適用
  dataRange.setVerticalAlignments(newAlignments);
  Logger.log("セルの内容に応じて垂直配置を自動調整しました。");
}

/**
 * 指定範囲の垂直配置を現在のタイムスタンプと共に履歴シートに記録する関数。
 * 「履歴ログシート」という名前のシートが存在することを前提とします。
 */
function monitorVerticalAlignmentChanges() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getActiveSheet();
  const historySheet = ss.getSheetByName('履歴ログシート'); // 履歴を記録するシート名

  if (!historySheet) {
    Logger.log("エラー: 履歴ログシートが見つかりません。");
    return;
  }

  const rangeToMonitor = sheet.getRange('A1:C10'); // 監視対象範囲
  const currentAlignments = rangeToMonitor.getVerticalAlignments(); // 現在の垂直配置を一括取得
  const timestamp = new Date(); // 現在のタイムスタンプ

  // 履歴シートに、タイムスタンプと垂直配置のJSON文字列を追記
  historySheet.appendRow([
    timestamp.toISOString(), // ISO形式の日時文字列
    JSON.stringify(currentAlignments) // 垂直配置の二次元配列をJSON文字列に変換
  ]);
  Logger.log(`範囲 ${rangeToMonitor.getA1Notation()} の垂直配置変更履歴を記録しました。`);
}