【GASスプレッドシート】getTextDirection()でテキスト方向を効率的に取得・SEO最適化

/**
 * アクティブなシートのA1セルのテキスト方向を取得し、ログに出力する関数。
 * 自動判定の場合は「null」が返ります。
 */
function basicGetTextDirection() {
  const sheet = SpreadsheetApp.getActiveSheet(); // アクティブなシートを取得
  const range = sheet.getRange("A1");           // A1セルをRangeオブジェクトとして取得
  const textDirection = range.getTextDirection(); // A1セルのテキスト方向を取得

  // 取得したテキスト方向をログに出力
  // textDirectionがnullの場合は「自動判定」と表示
  Logger.log(`A1セルのテキスト方向: ${textDirection ? textDirection.toString() : "自動判定 (LEFT_TO_RIGHT)"}`);
}

// 例: B2セルにテキスト方向を明示的に設定
// sheet.getRange("B2").setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

/**
 * 複数範囲のセルのテキスト方向を一括取得し、ログに出力する関数。
 * getRange("A1:B2") の場合、[[A1の方向, B1の方向], [A2の方向, B2の方向]] の形式で返されます。
 */
function logAllTextDirections() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1:B2"); // 対象範囲をA1:B2に設定
  const directions = range.getTextDirections(); // 範囲内の全セルのテキスト方向を一括取得

  Logger.log(`A1:B2範囲のテキスト方向:\n${JSON.stringify(directions, null, 2)}`);
  /* 例: directions の出力形式
   * [
   *   [SpreadsheetApp.TextDirection.LEFT_TO_RIGHT, null],
   *   [null, SpreadsheetApp.TextDirection.RIGHT_TO_LEFT]
   * ]
   */
}

/**
 * スプレッドシートのデータ範囲のテキストを言語判定し、
 * 言語に応じてテキスト方向を自動設定する関数。
 * アラビア語やヘブライ語の場合にRIGHT_TO_LEFTを設定します。
 */
function autoSetTextDirectionByLanguage() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getDataRange(); // シート内のデータが存在する全範囲を取得
  const values = range.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;
      }
    })
  );
  
  // 生成した新しいテキスト方向を一括でシートに設定
  range.setTextDirections(newDirections);
  Logger.log("言語に基づいてテキスト方向を自動設定しました。");
}

// const sheet = SpreadsheetApp.getActiveSheet();
// for (let i = 1; i <= 1000; i++) {
//   sheet.getRange(i, 1).setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);
// }
// -> API呼び出しが1000回発生し、非常に遅くなります。

/**
 * 大量のセルに対してテキスト方向を一括で設定する効率的な関数。
 * 例: A1からA1000までのセルをRIGHT_TO_LEFTに設定。
 */
function setTextDirectionBatchExample() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const targetRange = sheet.getRange("A1:A1000"); // 対象範囲

  // 1000行分のRIGHT_TO_LEFT方向を指定する二次元配列を作成
  const directionsArray = new Array(1000).fill([SpreadsheetApp.TextDirection.RIGHT_TO_LEFT]);
  
  // テキスト方向を一括で設定
  targetRange.setTextDirections(directionsArray);
  Logger.log("A列の1000セルにテキスト方向を一括設定しました。");
}

/**
 * テキスト方向の設定が即座に反映されるようにflush()を呼び出す例。
 */
function setTextDirectionAndFlush() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const cell = sheet.getRange("A1");
  cell.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);
  SpreadsheetApp.flush(); // ここで変更を強制的に反映
  Logger.log(`A1セルのテキスト方向をRIGHT_TO_LEFTに設定し、即時反映しました。`);
}

// 条件付き書式ルールでテキスト方向が設定されている例
// const rule = SpreadsheetApp.newConditionalFormatRule()
//   .whenFormulaSatisfied('=ISODD(ROW())') // 奇数行の場合
//   .setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT)
//   .build();
// sheet.setConditionalFormatRules([rule]);