【GASスプレッドシート】getTextStyles()で複数セルの書式情報を効率的に一括取得・SEO最適化

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

  // 取得した二次元配列の各要素（TextStyleオブジェクト）をループ処理
  stylesMatrix.forEach((rowStyles, rowIndex) => {
    rowStyles.forEach((cellStyle, colIndex) => {
      // getCell(row, column) は1から始まるインデックス
      const cellAddress = range.getCell(rowIndex + 1, colIndex + 1).getA1Notation();
      if (cellStyle) {
        Logger.log(`--- セル ${cellAddress} のスタイル ---`);
        Logger.log(`  フォントファミリー: ${cellStyle.getFontFamily() || 'なし'}`);
        Logger.log(`  フォントサイズ: ${cellStyle.getFontSize() || 'なし'}pt`);
        Logger.log(`  太字: ${cellStyle.isBold() ? "有効" : "無効"}`);
        Logger.log(`  文字色: ${cellStyle.getForegroundColor() || 'なし'}`);
      } else {
        Logger.log(`--- セル ${cellAddress} にはTextStyle情報がありません ---`);
      }
    });
  });
}

/**
 * 指定範囲内のテキストスタイルが統一されているかをチェックし、異なるセルを特定する関数。
 * 必要に応じてスタイルを自動修正する機能も実装できます。
 */
function checkAndCorrectTextStylesUniformity() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const rangeToCheck = sheet.getRange("A1:E10"); // チェック対象範囲
  const stylesMatrix = rangeToCheck.getTextStyles();
  
  if (stylesMatrix.length === 0 || stylesMatrix[0].length === 0) {
    Logger.log("チェック対象範囲にセルがありません。");
    return;
  }

  // 基準となるスタイルを範囲の左上隅のセルから取得
  const baseStyle = stylesMatrix[0][0]; 
  const differences = [];
  const newStylesMatrix = []; // 修正後のスタイルを格納する配列

  stylesMatrix.forEach((rowStyles, rowIndex) => {
    const newRow = [];
    rowStyles.forEach((cellStyle, colIndex) => {
      let isDifferent = false;
      // フォントファミリー、サイズ、太字の状態を比較
      if (cellStyle.getFontFamily() !== baseStyle.getFontFamily() ||
          cellStyle.getFontSize() !== baseStyle.getFontSize() ||
          cellStyle.isBold() !== baseStyle.isBold()) {
        isDifferent = true;
      }

      if (isDifferent) {
        differences.push(rangeToCheck.getCell(rowIndex + 1, colIndex + 1).getA1Notation());
        // ★オプション: ここでgetTextStyle()を使って自動修正することも可能
        // newRow.push(baseStyle); // 基準スタイルで上書き
        newRow.push(SpreadsheetApp.newTextStyle()
            .setFontFamily(baseStyle.getFontFamily())
            .setFontSize(baseStyle.getFontSize())
            .setBold(baseStyle.isBold())
            .build());
      } else {
        newRow.push(cellStyle); // 変更がなければ元のスタイルを再利用
      }
    });
    newStylesMatrix.push(newRow);
  });
  
  if (differences.length > 0) {
    Logger.log(`異なるスタイルのセルが検出されました: ${differences.join(", ")}`);
    // スタイルを自動修正する場合
    // rangeToCheck.setTextStyles(newStylesMatrix);
    // Logger.log("検出された異なるスタイルを基準スタイルに修正しました。");
  } else {
    Logger.log("指定範囲のすべてのセルのスタイルは統一されています。");
  }
}

/**
 * リッチテキストを含むセル範囲の部分スタイルをgetRichTextValues()と組み合わせて解析する関数。
 * 例: A1:C3範囲内のリッチテキストを解析。
 */
function analyzeRichTextStylesBatch() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1:C3");
  const richTextValues = range.getRichTextValues(); // リッチテキスト情報を一括取得

  richTextValues.forEach((rowRichTextValues, rowIndex) => {
    rowRichTextValues.forEach((richTextValue, colIndex) => {
      const cellAddress = range.getCell(rowIndex + 1, colIndex + 1).getA1Notation();
      if (richTextValue) {
        richTextValue.getRuns().forEach((run, runIndex) => {
          const runText = run.getText();
          const runStyle = run.getTextStyle();
          if (runStyle.isBold()) {
            Logger.log(`セル ${cellAddress} のリッチテキスト内（「${runText}」）で太字が検出されました。`);
          }
          // 他のスタイル（色、サイズなど）もここでチェック可能
        });
      }
    });
  });
  Logger.log("リッチテキスト内のスタイル解析が完了しました。");
}

/**
 * スプレッドシートの指定範囲のテキストスタイルを、Googleスライドの複数図形テキストに適用する関数。
 * Google Slides APIの有効化が必要な場合があります。
 * ★注意: この例は概念的なもので、各図形のオブジェクトIDを事前に知る必要があります。
 */
function applySheetStylesToMultipleSlideShapes() {
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = spreadsheet.getActiveSheet();
  const sourceRange = sheet.getRange("A1:C3"); // スタイルコピー元の範囲
  const sourceStyles = sourceRange.getTextStyles(); // スタイル情報を一括取得

  const presentationId = 'YOUR_PRESENTATION_ID'; // ★実際のスライドIDに置き換えてください
  const slideIndex = 0; // 対象スライドのインデックス（0から始まる）

  try {
    const presentation = SlidesApp.openById(presentationId);
    const slide = presentation.getSlides()[slideIndex];
    const shapes = slide.getShapes(); // スライド内のすべての図形を取得

    sourceStyles.forEach((rowStyles, rowIndex) => {
      rowStyles.forEach((cellStyle, colIndex) => {
        // 例: スプレッドシートのA1スタイルをスライドの最初の図形に、A2を二番目の図形に...
        // 実際には、スプレッドシートのセルとスライドの図形オブジェクトIDをマッピングする必要があります。
        const targetShapeIndex = rowIndex * sourceStyles[0].length + colIndex;
        if (shapes.length > targetShapeIndex) {
          const targetShape = shapes[targetShapeIndex];
          const targetTextRange = targetShape.getText();
          const targetTextStyle = targetTextRange.getTextStyle();

          if (cellStyle && targetTextStyle) {
            if (cellStyle.getFontFamily()) {
              targetTextStyle.setFontFamily(cellStyle.getFontFamily());
            }
            if (cellStyle.getFontSize()) {
              targetTextStyle.setFontSize(cellStyle.getFontSize());
            }
            targetTextStyle.setBold(cellStyle.isBold());
            targetTextStyle.setItalic(cellStyle.isItalic());
            targetTextStyle.setUnderline(cellStyle.isUnderline());
            if (cellStyle.getForegroundColor()) {
              targetTextStyle.setForegroundColor(cellStyle.getForegroundColor());
            }
            // 他のスタイルも同様に適用
          }
        }
      });
    });
    Logger.log(`スプレッドシートのスタイルをスライドの複数の図形テキストに適用しました。`);
  } catch (e) {
    Logger.log(`Googleスライド連携エラー: ${e.message}`);
  }
}