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

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

  // 取得した二次元配列の内容をJSON形式でログに出力 (視認性のため整形)
  Logger.log(`B2:E3範囲のテキスト方向:\n${JSON.stringify(directions, null, 2)}`);
  /* 例: directions の出力形式
   * [
   *   [SpreadsheetApp.TextDirection.LEFT_TO_RIGHT, null, "LEFT_TO_RIGHT", "RIGHT_TO_LEFT"],
   *   [null, SpreadsheetApp.TextDirection.LEFT_TO_RIGHT, null, "LEFT_TO_RIGHT"]
   * ]
   */
  
  // 各セルのアドレスと共に方向を出力する例
  directions.forEach((rowDirections, rowIndex) => {
    rowDirections.forEach((direction, colIndex) => {
      // getCell(row, column) は1から始まるインデックス
      const cellAddress = range.getCell(rowIndex + 1, colIndex + 1).getA1Notation();
      Logger.log(`セル ${cellAddress} のテキスト方向: ${direction ? direction.toString() : "自動判定"}`);
    });
  });
}

/**
 * スプレッドシートのデータ範囲のテキストを言語判定し、
 * 言語に応じてテキスト方向を自動設定する関数。
 * アラビア語やヘブライ語の場合にRIGHT_TO_LEFTを設定します。
 */
function autoSetTextDirectionsByLanguage() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const dataRange = sheet.getDataRange(); // シート内のデータが存在する全範囲を取得
  const values = dataRange.getValues();   // データ範囲の値を二次元配列として取得

  // 新しいテキスト方向を格納する二次元配列を作成
  const newDirections = values.map(row => 
    row.map(cellValue => {
      // 文字列でない、または空の場合はnull（自動判定）とする
      if (typeof cellValue !== 'string' || cellValue === '') {
        return null; 
      }
      
      // テキストの言語を検出
      const detectedLang = LanguageApp.detect(cellValue);

      // アラビア語 (ar) またはヘブライ語 (he) の場合はRIGHT_TO_LEFT、それ以外はLEFT_TO_RIGHT
      if (detectedLang.includes('ar') || detectedLang.includes('he')) {
        return SpreadsheetApp.TextDirection.RIGHT_TO_LEFT;
      } else {
        return SpreadsheetApp.TextDirection.LEFT_TO_RIGHT;
      }
    })
  );
  
  // 生成した新しいテキスト方向を一括でシートに設定
  dataRange.setTextDirections(newDirections);
  Logger.log("言語に基づいてテキスト方向を自動設定しました。");
}

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

  const allNewDirections = []; // 全体の新しいテキスト方向を格納する配列

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

    const batchNewDirections = batchValues.map(row => 
      row.map(cellValue => {
        // ここにgetTextDirections()で取得した既存の方向情報や、
        // LanguageApp.detect() を使った言語判定ロジックを適用
        return (typeof cellValue === 'string' && cellValue.includes('RTL')) 
               ? SpreadsheetApp.TextDirection.RIGHT_TO_LEFT 
               : SpreadsheetApp.TextDirection.LEFT_TO_RIGHT;
      })
    );
    allNewDirections.push(...batchNewDirections); // 全体配列に追加
  }

  // 全てのバッチ処理が完了した後、一括でsetTextDirections()
  // この例では、最終的に全てのデータを取得・処理してから一括設定するため、
  // range.setTextDirections()をループ外で行うことを想定
  fullRange.setTextDirections(allNewDirections); 
  Logger.log("大規模データ範囲のテキスト方向を効率的に処理しました。");
}

/**
 * CacheServiceを活用して、getTextDirections()のパフォーマンスを向上させる関数。
 * 10分間キャッシュを保持します。
 */
function cachedTextDirectionsAnalysis() {
  const cache = CacheService.getScriptCache(); // スクリプトキャッシュを取得
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('分析シート');
  if (!sheet) {
    Logger.log("エラー: '分析シート' が見つかりません。");
    return;
  }
  const range = sheet.getRange('A1:Z1000'); // 対象範囲
  const cacheKey = `directions_sheet_${sheet.getSheetId()}_range_${range.getA1Notation()}`; // キャッシュキーを生成
  
  let directions = cache.get(cacheKey); // キャッシュからデータを取得
  if (directions) {
    directions = JSON.parse(directions); // 文字列をJSONオブジェクトに変換
    Logger.log("テキスト方向データをキャッシュから取得しました。");
  } else {
    // キャッシュがない場合、getTextDirections()を実行し、キャッシュに保存
    directions = range.getTextDirections();
    cache.put(cacheKey, JSON.stringify(directions), 600); // 10分間 (600秒) キャッシュに保存
    Logger.log("テキスト方向データを取得し、キャッシュに保存しました。");
  }
  
  // ここで取得した方向データ (directions) を使用して処理を行う
  // 例: directions[0][0] を参照
  if (directions && directions.length > 0 && directions[0].length > 0) {
    Logger.log(`A1セルのテキスト方向 (キャッシュ経由): ${directions[0][0] ? directions[0][0].toString() : "自動判定"}`);
  }
}

/**
 * setTextDirections()の変更を即座にスプレッドシートに反映させる関数。
 */
function setTextDirectionsAndFlushExample() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1:A5");
  const directionsArray = new Array(5).fill([SpreadsheetApp.TextDirection.RIGHT_TO_LEFT]);
  
  range.setTextDirections(directionsArray); // テキスト方向を設定
  SpreadsheetApp.flush(); // ここで設定変更を強制的に反映
  Logger.log(`A1:A5セルのテキスト方向をRIGHT_TO_LEFTに設定し、即時反映しました。`);
}