【GASスプレッドシート】getRichTextValue()でリッチテキスト情報を取得・SEO最適化

/**
 * アクティブなシートのA1セルからリッチテキスト情報を取得し、
 * テキスト内容と基本スタイル情報をログに出力する関数。
 */
function getRichTextInfoBasic() {
  const sheet = SpreadsheetApp.getActiveSheet(); // アクティブなシートを取得
  const range = sheet.getRange("A1");           // 対象セルA1をRangeオブジェクトとして取得
  const richTextValue = range.getRichTextValue(); // A1セルのRichTextValueオブジェクトを取得

  // RichTextValueオブジェクトが存在するか確認
  if (richTextValue) {
    // プレーンテキスト（書式なしのテキスト）を取得
    Logger.log(`A1セルのプレーンテキスト: "${richTextValue.getText()}"`); 
    
    // セル全体のテキストスタイルを取得
    const textStyle = richTextValue.getTextStyle();
    Logger.log(`A1セル全体が太字かどうか: ${textStyle.isBold() ? 'はい' : 'いいえ'}`);
    Logger.log(`A1セル全体のフォントサイズ: ${textStyle.getFontSize()}pt`);
    Logger.log(`A1セル全体のフォント色: ${textStyle.getForegroundColor()}`);
  } else {
    // リッチテキスト情報がない場合（例: 空白セル、数値/日付フォーマットのセル）
    Logger.log(`A1セルにはリッチテキスト情報が見つかりませんでした。`);
  }
}

/**
 * セル内のテキストの一部分に適用されたスタイルを取得する関数。
 * 例: A1セルに「Hello **GAS** World!」と入力されている場合。
 */
function getPartialTextStyle() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const richTextValue = sheet.getRange("A1").getRichTextValue(); // 例: A1に"Hello GAS World!"と入力されていると仮定

  if (richTextValue) {
    // テキスト"GAS" (インデックス6から9) のスタイルを取得
    // "Hello GAS World!" -> H(0)e(1)l(2)l(3)o(4) (5)G(6)A(7)S(8) (9)W(10)...
    const partialTextStyle = richTextValue.getTextStyle(6, 9); 
    
    Logger.log(`「GAS」部分が太字かどうか: ${partialTextStyle.isBold() ? 'はい' : 'いいえ'}`);
    Logger.log(`「GAS」部分のフォント色: ${partialTextStyle.getForegroundColor()}`);
  }
}

/**
 * 単一のハイパーリンクが設定されたセルのURLを取得する関数。
 * 例: A1セルに「[Google](https://www.google.com/)」とリンクが設定されている場合。
 */
function getSingleLinkUrl() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const richTextValue = sheet.getRange("A1").getRichTextValue();
  
  if (richTextValue) {
    const linkUrl = richTextValue.getLinkUrl();
    if (linkUrl) {
      Logger.log(`A1セルのリンク先URL: ${linkUrl}`);
    } else {
      Logger.log(`A1セルには単一のリンクが見つかりませんでした。`);
    }
  }
}

/**
 * 複数リンクを含むセルのリッチテキスト情報をgetRuns()で解析する関数。
 * 例: A1セルに「[Google](https://www.google.com/) と [Yahoo](https://www.yahoo.com/)」と入力されている場合。
 */
function getMultipleLinksWithRuns() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const richTextValue = sheet.getRange("A1").getRichTextValue();

  if (richTextValue) {
    const runs = richTextValue.getRuns(); // スタイルが異なる部分ごとにRichTextValueオブジェクトの配列を取得
    Logger.log(`A1セルのリッチテキストは ${runs.length} つのランに分割されました。`);

    runs.forEach((run, index) => {
      const runText = run.getText();    // 各ランのテキスト部分
      const runLinkUrl = run.getLinkUrl(); // 各ランに設定されているリンクURL
      const runStyle = run.getTextStyle(); // 各ランに設定されているスタイル

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

/**
 * 日付や数値フォーマットのセルからリッチテキストを取得する際の注意点と対策。
 */
function handleFormattedCellForRichText() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1"); // 例: A1に日付が入力されていると仮定

  const originalFormat = range.getNumberFormat(); // 元の表示形式を保存
  
  try {
    range.setNumberFormat('@'); // 一時的に文字列フォーマットに変更
    SpreadsheetApp.flush();     // 変更を即時反映 (重要)

    const richTextValue = range.getRichTextValue();
    if (richTextValue) {
      Logger.log(`文字列として取得したテキスト: ${richTextValue.getText()}`);
      // ここでリッチテキストの解析処理を行う
    } else {
      Logger.log(`A1セルにリッチテキスト情報が見つかりませんでした（フォーマット変更後）。`);
    }
  } finally {
    // 処理後、必ず元の表示形式に戻す
    range.setNumberFormat(originalFormat);
    Logger.log(`A1セルの表示形式を元の "${originalFormat}" に戻しました。`);
  }
}

/**
 * 複数セルのリッチテキスト情報をgetRichTextValues()で一括取得し、処理する関数。
 */
function getAllRichTextValuesBatch() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1:C5"); // 処理対象範囲
  
  // 指定範囲のRichTextValueオブジェクトを二次元配列として一括取得
  const richTextValues = range.getRichTextValues();

  richTextValues.forEach((row, rowIndex) => {
    row.forEach((richTextValue, colIndex) => {
      const cellAddress = sheet.getRange(rowIndex + 1, colIndex + 1).getA1Notation();
      if (richTextValue) {
        Logger.log(`セル ${cellAddress} のテキスト: ${richTextValue.getText()}`);
        // さらにgetTextStyle(), getLinkUrl(), getRuns()などで詳細解析
      } else {
        Logger.log(`セル ${cellAddress} にはリッチテキスト情報がありません。`);
      }
    });
  });
}