Googleドキュメントで「セクションごとの文字数」を自動で数える方法【GAS活用編】

2025年6月14日

1 はじめに
2 Googleドキュメントで「セクションごとの文字数」を自動で数える方法
3 機能の概要
- 3.1 countSectionChars（文字数を挿入）
- 3.2 clearSectionChars（注記の削除）
4 活用できそうな場面
5 実行イメージ
- 5.1 カウント実行（countSectionChars）
- 5.2 クリア実行（clearSectionChars）
6 GAS（Google Apps Script）のソースコード
7 実行方法【GAS未経験者向け】
- 7.1 「このアプリはGoogleで確認されていません」という画面が表示された

はじめに

いつもブログをご覧いただきありがとうございます。

ミジンコに転生したIPUSIRONです😀

IPUSIRONのプロフィールを見る

必要に迫られて、ボリューム感を可視化するGASスクリプトを作成しました。
まあまあ便利なので、共有することにします

Googleドキュメントで「セクションごとの文字数」を自動で数える方法

Googleドキュメントで原稿を執筆していると、章や節ごとに文字数を把握したくなることがあります。

今回紹介するのは、見出し単位（Heading 1〜3）で文字数を自動集計し、各セクションの直後に注記として挿入するスクリプトです。

機能の概要

紹介するGASスクリプトとして、以下の2つがあります。

カウント実行（countSectionChars）
クリア実行（clearSectionChars）

countSectionChars（文字数を挿入）

Heading 1〜3 の見出しを起点に、次の見出しまでの本文を「セクション」と定義
各セクションの文字数（全角・半角・記号すべて）をカウント
見出し段落自体の文字も含めてカウント
通常の段落だけでなく、箇条書き（リスト）項目も対象
結果は見出しの次の段落に自動で挿入
スタイル：グレー文字・9pt・右寄せ

clearSectionChars（注記の削除）

上記で挿入された 「（このセクション：○○文字）」 という注記だけをドキュメントから削除する
正規表現にマッチする注記のみ削除する
他の本文に影響しない

活用できそうな場面

ドキュメントの章構成を確認しながら執筆する。
編集者とのレビュー共有時に「この章は少ない」「ここは多すぎ」などの視覚的判断に使う。
段階的な分量調整が必要な技術書執筆や商業原稿での利用に適している。

実行イメージ

以下のGoogleドキュメントがあったとします。

それぞれの実行結果は、以下のとおりです。

カウント実行（countSectionChars）

クリア実行（clearSectionChars）

カウントした文字数は、原稿に埋め込まれたまま保存されています。

表示されている文字数は自分（執筆者）のチェック用としては有用ですが、編集者に提出時には不要な情報かもしれません。

不要であれば、すべて削除する必要があります。

そこで、クリア処理のための関数も用意しました。

GAS（Google Apps Script）のソースコード

function countSectionChars() {
  const body = DocumentApp.getActiveDocument().getBody();

  let i = 0;
  while (i < body.getNumChildren()) {
    const element = body.getChild(i);

    if (
      element.getType() === DocumentApp.ElementType.PARAGRAPH &&
      [DocumentApp.ParagraphHeading.HEADING1,
       DocumentApp.ParagraphHeading.HEADING2,
       DocumentApp.ParagraphHeading.HEADING3].includes(element.asParagraph().getHeading())
    ) {
      const headingPara = element.asParagraph();
      const headingLevel = headingPara.getHeading();

      // 見出し自体の文字数もカウント
      let blockCharCount = headingPara.getText().replace(/\n/g, '').length;

      let j = i + 1;

      while (j < body.getNumChildren()) {
        const nextElem = body.getChild(j);
        const nextType = nextElem.getType();

        if (
          nextType === DocumentApp.ElementType.PARAGRAPH &&
          [DocumentApp.ParagraphHeading.HEADING1,
           DocumentApp.ParagraphHeading.HEADING2,
           DocumentApp.ParagraphHeading.HEADING3].includes(nextElem.asParagraph().getHeading())
        ) {
          break;
        }

        if (
          nextType === DocumentApp.ElementType.PARAGRAPH ||
          nextType === DocumentApp.ElementType.LIST_ITEM
        ) {
          const text = nextElem.getText().replace(/\n/g, '');
          blockCharCount += text.length;
        }

        j++;
      }

      // 見出し1 でも本文がなければ注記スキップしない（見出し含むので0文字にはならない）
      const expectedText = `（このセクション：${blockCharCount}文字）`;

      const nextIndex = i + 1;
      const nextExists = nextIndex < body.getNumChildren();
      const nextPara = nextExists ? body.getChild(nextIndex) : null;

      if (
        nextExists &&
        nextPara.getText().trim().match(/^（このセクション：\d+文字）$/)
      ) {
        if (nextPara.getText().trim() !== expectedText) {
          nextPara.setText(expectedText);
          nextPara.setForegroundColor('#888888');
          nextPara.setFontSize(9);
          nextPara.setAlignment(DocumentApp.HorizontalAlignment.RIGHT);
        }
        i = j;
      } else {
        const inserted = body.insertParagraph(nextIndex, expectedText);
        inserted.setForegroundColor('#888888');
        inserted.setFontSize(9);
        inserted.setAlignment(DocumentApp.HorizontalAlignment.RIGHT);
        i = j + 1;
      }
    } else {
      i++;
    }
  }
}

function clearSectionChars() {
  const body = DocumentApp.getActiveDocument().getBody();
  const paragraphs = body.getParagraphs();

  for (let i = paragraphs.length - 1; i >= 0; i--) {
    const para = paragraphs[i];
    const text = para.getText().trim();

    // 「（このセクション：○○文字）」の形式に完全一致する段落を削除
    if (text.match(/^（このセクション：\d+文字）$/)) {
      body.removeChild(para);
    }
  }
}

※この記事中のコードは初期バージョンです。最新版はGitHubで公開しています。
→ GitHubリポジトリはこちら