【GASスプレッドシート】getRichTextValues()でリッチテキストを一括取得・編集・SEO最適化

/**
 * アクティブなシートの指定範囲（A1:C3）からリッチテキスト情報を一括取得し、
 * 各セルのプレーンテキストをログに出力する関数。
 */
function fetchAllRichTextData() {
  const sheet = SpreadsheetApp.getActiveSheet(); // アクティブなシートを取得
  const range = sheet.getRange("A1:C3");      // 対象範囲をA1:C3に設定
  
  // 指定範囲の各セルのRichTextValueオブジェクトを二次元配列として一括取得
  const richTextValues = range.getRichTextValues();

  // 取得した二次元配列をループ処理
  richTextValues.forEach((row, rowIndex) => {
    row.forEach((richTextValue, colIndex) => {
      const cellAddress = sheet.getRange(rowIndex + 1, colIndex + 1).getA1Notation();
      if (richTextValue) {
        // RichTextValueオブジェクトからプレーンテキストを取得
        Logger.log(`セル ${cellAddress} のプレーンテキスト: "${richTextValue.getText()}"`);
      } else {
        Logger.log(`セル ${cellAddress} にはリッチテキスト情報がありません（空白または数値/日付）。`);
      }
    });
  });
}

/**
 * A1セルのリッチテキストをgetRuns()で解析し、各ランのテキストとスタイルをログに出力する関数。
 * 例: A1セルに「これは**重要な情報**です」と入力されている場合。
 */
function analyzeRichTextRuns() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const richTextValue = sheet.getRange("A1").getRichTextValue(); // A1セルのRichTextValueを取得

  if (richTextValue) {
    const runs = richTextValue.getRuns(); // スタイルが異なる区間ごとにRichTextValueオブジェクトを取得

    Logger.log(`A1セルのリッチテキストは ${runs.length} つのランに分割されました。`);

    runs.forEach((run, index) => {
      const runText = run.getText();         // 各ランのテキスト部分
      const runStyle = run.getTextStyle();     // 各ランに適用されたTextStyleオブジェクト
      const runLinkUrl = run.getLinkUrl();   // 各ランに設定されたハイパーリンクURL

      Logger.log(`--- ラン ${index + 1} ---`);
      Logger.log(`  テキスト: "${runText}"`);
      Logger.log(`  太字: ${runStyle.isBold() ? 'はい' : 'いいえ'}`);
      Logger.log(`  フォント色: ${runStyle.getForegroundColor() || 'なし'}`);
      if (runLinkUrl) {
        Logger.log(`  リンク先URL: ${runLinkUrl}`);
      }
      // 他にもgetTextStyle()で取得できる様々なスタイル情報（フォントサイズ、斜体など）を解析可能
    });
  } else {
    Logger.log(`A1セルにはリッチテキスト情報が見つかりませんでした。`);
  }
}

/**
 * 新しいリッチテキストをプログラムで作成し、A1セルに設定する関数。
 * 「Hello」を太字、「World!」を赤字で表示します。
 */
function createAndApplyRichText() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const cell = sheet.getRange("A1");

  // RichTextValueBuilderを作成し、テキストとスタイルを設定
  const richTextBuilder = SpreadsheetApp.newRichTextValue()
    .setText("Hello, World!")
    // テキストの一部（0文字目から5文字目「Hello」）を太字に設定
    .setTextStyle(0, 5, SpreadsheetApp.newTextStyle().setBold(true).build())
    // テキストの一部（7文字目から13文字目「World!」）を赤字に設定
    .setTextStyle(7, 13, SpreadsheetApp.newTextStyle().setForegroundColor("red").build());
  
  // 構築したRichTextValueオブジェクトをセルに適用
  cell.setRichTextValue(richTextBuilder.build());
  Logger.log("A1セルに新しいリッチテキストを設定しました。");
}

/**
 * セル内のテキストの一部にハイパーリンクを設定する関数。
 * B1セルに「詳しくはGoogle公式サイトへ」と表示し、「Google公式サイト」にリンクを設定します。
 */
function addHyperlinkToText() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const cell = sheet.getRange("B1");

  const richTextBuilder = SpreadsheetApp.newRichTextValue()
    .setText("詳しくはGoogle公式サイトへ")
    // テキストの一部（4文字目から12文字目「Google公式サイト」）にリンクを設定
    .setLinkUrl(4, 12, "https://www.google.com"); 

  cell.setRichTextValue(richTextBuilder.build());
  Logger.log("B1セルにハイパーリンク付きリッチテキストを設定しました。");
}

/**
 * 指定されたテキストを検索し、スタイルを保持したまま新しいテキストに置換する関数。
 * ★注意: テキスト長が変わるとスタイルのインデックスがずれるため、本番利用には詳細なロジックが必要です。
 */
function replaceTextPreservingStyle(sheet, targetRange, searchText, replaceText) {
  const richTextValues = targetRange.getRichTextValues(); // 範囲のリッチテキストを一括取得
  const newRichTextValues = [];

  richTextValues.forEach((row, rowIndex) => {
    const newRow = [];
    row.forEach((richTextValue, colIndex) => {
      if (!richTextValue) { // リッチテキスト情報がない場合はそのまま
        newRow.push(richTextValue);
        return;
      }

      const originalText = richTextValue.getText();
      const newText = originalText.replace(new RegExp(searchText, "g"), replaceText);

      if (originalText !== newText) {
        const builder = SpreadsheetApp.newRichTextValue().setText(newText);
        let currentIndex = 0; // 新しいテキストでの現在のインデックス位置

        richTextValue.getRuns().forEach(run => {
          const runOriginalText = run.getText();
          const runOriginalLength = runOriginalText.length;
          const runNewText = runOriginalText.replace(new RegExp(searchText, "g"), replaceText);
          const runNewLength = runNewText.length;

          // TODO: ここで新しいテキストにおけるrunの開始/終了インデックスを正確に計算するロジックが必要
          // 現状の単純な計算では、searchTextの出現位置とreplaceTextの長さによってずれる
          const newStartIndex = currentIndex;
          const newEndIndex = currentIndex + runNewLength;
          
          builder.setTextStyle(newStartIndex, newEndIndex, run.getTextStyle());
          builder.setLinkUrl(newStartIndex, newEndIndex, run.getLinkUrl());
          currentIndex += runNewLength; // 次のランの開始位置を更新
        });
        newRow.push(builder.build());
      } else {
        newRow.push(richTextValue); // 変更がない場合は元のRichTextValueをそのまま使用
      }
    });
    newRichTextValues.push(newRow);
  });
  targetRange.setRichTextValues(newRichTextValues); // 新しいリッチテキストを一括設定
  Logger.log(`範囲 ${targetRange.getA1Notation()} 内のテキスト置換が完了しました。`);
}