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

/**
 * アクティブなシートのA1セルのテキストスタイルを取得し、ログに出力する関数。
 */
function getSingleCellTextStyle() {
  const sheet = SpreadsheetApp.getActiveSheet(); // アクティブなシートを取得
  const cell = sheet.getRange("A1");           // A1セルをRangeオブジェクトとして取得
  const textStyle = cell.getTextStyle();      // A1セルのTextStyleオブジェクトを取得
  
  // TextStyleオブジェクトから各スタイル情報を取得しログに出力
  Logger.log(`A1セルのフォントファミリー: ${textStyle.getFontFamily()}`);
  Logger.log(`A1セルのフォントサイズ: ${textStyle.getFontSize()}pt`);
  Logger.log(`A1セルの太字状態: ${textStyle.isBold() ? "有効" : "無効"}`);
  Logger.log(`A1セルの文字色: ${textStyle.getForegroundColor()}`);
}

/**
 * リッチテキストが設定されたセル（A1）の部分的なスタイルを解析する関数。
 * 例: A1セルに「Hello **GAS** World!」と入力されている場合。
 */
function getRichTextPartialStyle() {
  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オブジェクト

      Logger.log(`--- ラン ${index + 1} ---`);
      Logger.log(`  テキスト: "${runText}"`);
      Logger.log(`  太字: ${runStyle.isBold() ? 'はい' : 'いいえ'}`);
      Logger.log(`  フォント色: ${runStyle.getForegroundColor() || 'なし'}`);
    });
  } else {
    Logger.log(`A1セルにはリッチテキスト情報が見つかりませんでした。`);
  }
}

/**
 * シートに設定された条件付き書式ルールを解析し、
 * 太字が適用されるルールを検出する関数。
 */
function analyzeConditionalFormattingStyles() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const rules = sheet.getConditionalFormatRules(); // シートの全条件付き書式ルールを取得

  if (rules.length === 0) {
    Logger.log("このシートには条件付き書式ルールが設定されていません。");
    return;
  }

  Logger.log("条件付き書式ルールを解析中...");
  rules.forEach((rule, index) => {
    Logger.log(`--- ルール ${index + 1} ---`);
    const textStyle = rule.getTextStyle(); // このルールで適用されるTextStyleを取得
    
    if (textStyle) { // TextStyleが設定されている場合
      if (textStyle.isBold()) {
        Logger.log(`  このルールは太字を設定しています。対象範囲: ${rule.getRanges().map(r => r.getA1Notation()).join(', ')}`);
      }
      if (textStyle.getForegroundColor()) {
        Logger.log(`  このルールは文字色「${textStyle.getForegroundColor()}」を設定しています。`);
      }
      // 他のTextStyleプロパティも同様にチェック可能
    } else {
      Logger.log(`  このルールにはテキストスタイルが設定されていません。`);
    }
  });
  Logger.log("条件付き書式の解析が完了しました。");
}

/**
 * 複数範囲のセルのテキストスタイルを一括取得し、斜体（イタリック体）が設定されているセルを検出する関数。
 */
function getRangeTextStylesAndDetectItalic() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const range = sheet.getRange("A1:C5"); // 対象範囲をA1:C5に設定
  const stylesMatrix = range.getTextStyles(); // 範囲内の全セルのTextStyleオブジェクトを一括取得

  Logger.log(`範囲 ${range.getA1Notation()} のテキストスタイルを解析中...`);

  stylesMatrix.forEach((rowStyles, rowIndex) => {
    rowStyles.forEach((cellStyle, colIndex) => {
      // getCell(row, column) は1から始まるインデックス
      const cellAddress = range.getCell(rowIndex + 1, colIndex + 1).getA1Notation();
      if (cellStyle && cellStyle.isItalic()) { // TextStyleが存在し、斜体であるかチェック
        Logger.log(`斜体（イタリック体）が設定されたセルが見つかりました: ${cellAddress}`);
      }
    });
  });
  Logger.log("テキストスタイルの解析が完了しました。");
}

/**
 * スプレッドシートのA1セルのテキストスタイルを、Googleスライドの指定図形テキストに適用する関数。
 * Google Slides APIの有効化が必要な場合があります。
 */
function applySheetStyleToSlideText() {
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = spreadsheet.getActiveSheet();
  const sourceCell = sheet.getRange("A1"); // コピー元のスタイルがあるセル
  const sourceTextStyle = sourceCell.getTextStyle(); // セルのTextStyleを取得

  // 例: Googleスライドのプレゼンテーションと図形IDを指定
  const presentationId = 'YOUR_PRESENTATION_ID'; // ★ここを実際のスライドIDに置き換えてください
  const slideId = 'YOUR_SLIDE_ID';             // ★ここを実際のスライドIDに置き換えてください
  const shapeObjectId = 'YOUR_SHAPE_OBJECT_ID'; // ★ここを実際の図形オブジェクトIDに置き換えてください

  // Slidesサービスを使ってプレゼンテーションと図形を取得
  const presentation = SlidesApp.openById(presentationId);
  const slide = presentation.getSlideById(slideId);
  const shape = slide.getShapeById(shapeObjectId);

  if (!shape || !shape.getText()) {
    Logger.log("エラー: 指定されたスライド図形またはそのテキストが見つかりません。");
    return;
  }

  const slideTextRange = shape.getText(); // スライド図形のTextRangeを取得
  const slideTextStyle = slideTextRange.getTextStyle(); // スライドテキストのTextStyleを取得

  // スプレッドシートのスタイルをスライドテキストに適用
  if (sourceTextStyle.getFontFamily()) {
    slideTextStyle.setFontFamily(sourceTextStyle.getFontFamily());
  }
  if (sourceTextStyle.getFontSize()) {
    slideTextStyle.setFontSize(sourceTextStyle.getFontSize());
  }
  slideTextStyle.setBold(sourceTextStyle.isBold());
  slideTextStyle.setItalic(sourceTextStyle.isItalic());
  slideTextStyle.setUnderline(sourceTextStyle.isUnderline());
  if (sourceTextStyle.getForegroundColor()) {
    slideTextStyle.setForegroundColor(sourceTextStyle.getForegroundColor());
  }
  
  Logger.log(`スプレッドシートのA1セルのスタイルを、スライドの図形テキストに適用しました。`);
  // ★注意: リッチテキストの部分的な書式転送には、より複雑なロジックが必要です。
}