【GASスプレッドシート】getTextRotations()で複数セルのテキスト回転を一括取得・SEO最適化

/**
 * アクティブなシートのB2:C3範囲の全セルのテキスト回転設定を一括取得し、ログに出力する関数。
 */
function getAndLogAllTextRotations() {
  const sheet = SpreadsheetApp.getActiveSheet(); // アクティブなシートを取得
  const range = sheet.getRange("B2:C3");      // 対象範囲をB2:C3に設定
  
  // 指定範囲の各セルのTextRotationオブジェクトを二次元配列として一括取得
  const rotations = range.getTextRotations();

  // 取得した二次元配列の各要素（TextRotationオブジェクト）をループ処理
  rotations.forEach((rowRotations, rowIndex) => {
    rowRotations.forEach((cellRotation, colIndex) => {
      // getCell(row, column) は1から始まるインデックス
      const cellAddress = range.getCell(rowIndex + 1, colIndex + 1).getA1Notation();
      Logger.log(`セル ${cellAddress}: 回転角度 ${cellRotation.getDegrees()}°, 縦書き ${cellRotation.isVertical() ? "有効" : "無効"}`);
    });
  });
}

/**
 * データ範囲内のセルのテキスト長に応じて、テキストの回転角度を動的に調整する関数。
 * テキスト長が15文字を超えるセルは45度回転させ、それ以外は0度に戻します。
 */
function adjustTextRotationBasedOnLength() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const dataRange = sheet.getDataRange();       // シート内のデータが存在する全範囲を取得
  const rotations = dataRange.getTextRotations(); // 全範囲のテキスト回転情報を一括取得
  const values = dataRange.getValues();         // 全範囲のセル値（テキスト長取得用）を一括取得

  const newRotations = []; // 新しい回転設定を格納する二次元配列

  rotations.forEach((rowRotations, rowIndex) => {
    const newRowRotations = [];
    rowRotations.forEach((cellRotation, colIndex) => {
      const cellValue = values[rowIndex][colIndex]; // セル値を取得
      const textLength = String(cellValue).length; // テキスト長を計算

      let targetDegrees = 0; // デフォルトは0度

      // テキストが縦書きではない場合のみ角度調整を検討
      if (!cellRotation.isVertical()) {
        if (textLength > 15) { // 例: テキストが15文字を超える場合
          targetDegrees = 45; // 45度回転
        }
      }

      // 現在の回転角度が目標と異なる場合のみ更新
      if (cellRotation.getDegrees() !== targetDegrees) {
        newRowRotations.push(SpreadsheetApp.newTextRotation().setDegrees(targetDegrees).build());
      } else {
        newRowRotations.push(cellRotation); // 変更不要な場合は既存のオブジェクトを再利用
      }
    });
    newRotations.push(newRowRotations);
  });
  
  // 新しい回転設定を一括でシートに適用
  dataRange.setTextRotations(newRotations);
  Logger.log("テキスト長に基づいて回転角度を動的に調整しました。");
}

/**
 * テンプレートシートのテキスト回転設定を、別のレポートシートに同期する関数。
 */
function synchronizeRotationsAcrossSheets() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sourceSheet = ss.getSheetByName('テンプレートシート'); // コピー元シート
  const targetSheet = ss.getSheetByName('レポートシート');   // コピー先シート
  
  if (!sourceSheet || !targetSheet) {
    Logger.log("エラー: ソースまたはターゲットシートが見つかりません。");
    return;
  }

  const sourceRange = sourceSheet.getRange('A1:D10'); // コピー元の範囲を指定
  const targetRange = targetSheet.getRange('A1:D10'); // コピー先の範囲を指定

  // コピー元の範囲からテキスト回転設定を一括取得
  const sourceRotations = sourceRange.getTextRotations();
  
  // コピー先の範囲に取得した設定を一括で適用
  targetRange.setTextRotations(sourceRotations);
  Logger.log(`「${sourceSheet.getName()}」シートの回転設定を、「${targetSheet.getName()}」シートの範囲 ${targetRange.getA1Notation()} に同期しました。`);
}

/**
 * 大規模なデータ範囲のテキスト回転設定を、バッチ処理で効率的に取得・設定する関数。
 */
function processLargeRangeTextRotationsEfficiently() {
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('大規模データ');
  if (!sheet) {
    Logger.log("エラー: '大規模データ' シートが見つかりません。");
    return;
  }
  const fullRange = sheet.getDataRange();
  const numRows = fullRange.getNumRows();
  const numCols = fullRange.getNumColumns();
  const batchSize = 1000; // 処理する行のバッチサイズ

  for (let i = 0; i < numRows; i += batchSize) {
    const currentBatchNumRows = Math.min(batchSize, numRows - i);
    const batchRange = fullRange.offset(i, 0, currentBatchNumRows, numCols); // 現在のバッチ範囲を取得

    // バッチ範囲のテキスト回転設定を取得
    const rotations = batchRange.getTextRotations();
    const newRotations = []; // 新しい回転設定を格納する配列

    rotations.forEach(rowRotations => {
      const newRow = rowRotations.map(cellRotation => {
        // 例: 縦書きのセルは中央揃えにする
        if (cellRotation.isVertical()) {
          // setTextRotation()はTextRotationオブジェクトを期待するため、新しいオブジェクトを構築
          return SpreadsheetApp.newTextRotation().setDegrees(0).setVertical(true).build(); 
        }
        return cellRotation; // 変更がなければ元のオブジェクトを使用
      });
      newRotations.push(newRow);
    });
    
    batchRange.setTextRotations(newRotations); // バッチ範囲に新しい回転設定を適用
    // Utilities.sleep(100); // 必要に応じてAPI呼び出し間隔を調整
  }
  Logger.log("大規模データ範囲のテキスト回転設定を効率的に処理しました。");
}