前回(第53回)は、Body.appendParagraph() を使って「札幌オフィス請求書」の下部に振込先口座案内や特記事項などの新しい段落を自由に追加する方法を学びましたね!
ドキュメントに文章を自動追加できるようになると、次に気になってくるのが「文章の見栄え・読みやすさ(装飾と文書構造)」です。
同じ大きさの文字がずらりと並んでいるだけだと、どこからが「ご請求明細」で、どこからが「振込先案内」なのか、一目で判別するのが難しくなってしまいます。
そこで第54回となる今回は、段落に対して「見出し1」「見出し2」「タイトル」といった見出しスタイルを一瞬で適用できる超重要メソッド Paragraph.setHeading() を徹底解説します!
「札幌オフィス請求書」の作成プログラムを題材に、実際にコードを動かしながら、実務で使える応用テクニックや初心者が必ずハマる注意点まで、どこよりも詳しく噛み砕いてお届けします!
1. そもそも Paragraph.setHeading() とは?
Paragraph.setHeading() は、Google ドキュメント内の特定の段落(Paragraphオブジェクト)に対して、見出しスタイル(Heading)を設定・変更するための命令(メソッド)です。
「家・部屋・家具」の例えで理解する位置づけ
本連載でおなじみの「家・部屋・家具」の例えを、Google ドキュメント(Docs)版でおさらいしてみましょう!
- 【建物全体】= ドキュメントファイル全体(
DocumentApp.openById()) - 【部屋】= ドキュメントの本文エリア(
Document.getBody()) - 【家具・棚】= 段落(
Body.getParagraphs()やBody.appendParagraph()) - 【棚の装飾・ラベル】= 見出し設定(
Paragraph.setHeading())★今回の主役!
Paragraph.setHeading() は、まさにこの「家具(段落)」に対して、目立つ大きな見出し看板を取り付けて部屋の構造をわかりやすく整理する操作にあたります。
コードの基本文法
// 1. 操作したい段落(Paragraph)を取得または作成する
var paragraph = body.appendParagraph("ご請求明細");
// 2. その段落を見出しスタイル(Heading 2)に設定する
paragraph.setHeading(DocumentApp.Heading.HEADING2);
第1回〜第10回で学んだスプレッドシート操作と同様、GASでは ドット(.) でつないで対象を絞り込み、命令を実行します。
DocumentApp.Heading(見出しの種類)一覧
setHeading() のカッコ内には、Google Apps Scriptがあらかじめ用意してくれている DocumentApp.Heading という定数(Enum)を指定します。
指定できる主な見出しスタイルは以下の通りです。
| 定数名(GASコード) | ドキュメント上のスタイル | 主な用途・使いどころ |
DocumentApp.Heading.TITLE | タイトル | 文書全体の最上部タイトル(例: 請求書、提案書) |
DocumentApp.Heading.SUBTITLE | サブタイトル | タイトルの直下に添える補足(例: 2026年9月度発行) |
DocumentApp.Heading.HEADING1 | 見出し 1 | 大見出し・章(例: 1. 概要、2. ご請求内容) |
DocumentApp.Heading.HEADING2 | 見出し 2 | 中見出し・節(例: ご請求明細、お振込先案内) |
DocumentApp.Heading.HEADING3 | 見出し 3 | 小見出し・項(例: 備考・特記事項) |
DocumentApp.Heading.HEADING4〜HEADING6 | 見出し 4 〜 6 | より細かい階層構造のテキスト |
DocumentApp.Heading.NORMAL | 標準テキスト | 見出しを解除して一般的な本文段落に戻す |
2. STEP1:準備!「札幌オフィス請求書テンプレート」を用意しよう
まずは、今回GASから操作するための練習用 Google ドキュメントを用意しましょう! 第51回〜第53回で作成したドキュメントがある方はそのまま活用していただいてOKです。
手順
- Google ドライブを開き、新しい Google ドキュメントを作成します。
- ドキュメントのタイトルを 「札幌オフィス請求書テンプレート」 に変更します。
- 本文エリアに、テスト用として以下のテキストを入力しておきましょう。
御請求書
札幌スープカレー本舗 御中
毎度格別のご引き立てを賜り、厚く御礼申し上げます。
下記のとおりご請求申し上げます。
ご請求明細
1. 札幌時計台前ビル ネットワーク設備保守費(9月分) 50,000円
2. クラウドサーバー運用代行費用 30,000円
お振込先口座のご案内
北海道銀行 札幌駅前支店 普通 1234567 カ)デジタルワンダーランド
- 画面上のURLバーから、ドキュメントID(
https://docs.google.com/document/d/と/editの間にある長英数字文字列)をコピーしておきます。
3. STEP2:【実践】「ご請求明細」を見出し(Heading 2)に設定してみよう!
準備ができたら、GASのエディタを開いてコードを書いていきましょう。
今回は、第51回で学んだ openById()、第53回で学んだ appendParagraph() を組み合わせつつ、「ご請求明細」 や 「お振込先口座のご案内」 の段落を自動で見出し(Heading 2)に設定してみます!
1. コードを入力する
スプレッドシートやスタンドアロンスクリプトのエディタ画面を開き、以下のコードを貼り付けます(YOUR_DOCUMENT_ID の部分をご自身のドキュメントIDに書き換えてください)。
function formatInvoiceHeadings() {
// ① 操作したいドキュメントを開き、本文エリア(Body)を取得する
var docId = "YOUR_DOCUMENT_ID"; // ←ご自身のドキュメントIDに書き換えてください
var doc = DocumentApp.openById(docId);
var body = doc.getBody();
// ② 本文内の全段落を取得する
var paragraphs = body.getParagraphs();
// ③ 段落を1つずつチェックし、特定の文字が含まれる段落を見出し(HEADING2)に設定する
for (var i = 0; i < paragraphs.length; i++) {
var p = paragraphs[i];
var text = p.getText();
// 「ご請求明細」または「お振込先口座のご案内」の段落を見出し2に設定
if (text === "ご請求明細" || text === "お振込先口座のご案内") {
p.setHeading(DocumentApp.Heading.HEADING2);
} else if (text === "御請求書") {
// 最上部の「御請求書」はタイトル(TITLE)に設定
p.setHeading(DocumentApp.Heading.TITLE);
}
}
// ④ 変更を保存してログ出力
doc.saveAndClose();
Logger.log("見出しスタイルの自動設定が完了しました!");
}
2. コードを1行ずつ徹底分解解説!
プログラミング初心者向けに、重要な処理を1行ずつ紐解いていきます!
var doc = DocumentApp.openById(docId);- 第51回で学んだ命令です。指定したIDの Google ドキュメントを開きます。
var paragraphs = body.getParagraphs();- ドキュメント本文に含まれるすべての段落を配列(リスト)として取得します。
for (var i = 0; i < paragraphs.length; i++)- ループ処理(繰り返し)を使って、ドキュメントの最初から最後までの段落を順番にチェックしています。
if (text === "ご請求明細" || text === "お振込先口座のご案内")- 段落の文字テキストを取り出し、一致するか判定しています。
p.setHeading(DocumentApp.Heading.HEADING2);- 本日の主役です!対象の段落
pに対して.setHeading()を呼び出し、見出し2のスタイルを反映させています。
- 本日の主役です!対象の段落
3. 実行結果を確認してみよう!
コードを保存し、「実行」ボタンを押してみましょう。
処理完了後、Google ドキュメントの画面を開いて確認します。
【実行結果の確認】
- 「御請求書」 の文字が大きく太い 「タイトル」 スタイルに変更された!
- 「ご請求明細」 と 「お振込先口座のご案内」 が綺麗な 「見出し 2」 スタイルに変更された!
- ドキュメント左側の 「概要(アウトライン)」パネル を開くと、「ご請求明細」「お振込先口座のご案内」が自動で目次のように追加されている!
ただのテキストの羅列だった書類が一瞬で構造化され、ビジネス文書として読みやすくなりましたね!
4. STEP3:実務で差がつく!setHeading() の応用パターン3選
単に既存の段落を変えるだけでなく、実務で頻繁に使う3つの発展的なテクニックを押さえておきましょう!
応用①:appendParagraph() と繋げて1行で段落追加&見出し化(メソッドチェーン)
第53回で学んだ appendParagraph() は、末尾に追記した段落オブジェクトをそのまま返してくれます。 そのため、以下のように ドット(.)で繋げて1行で書く(メソッドチェーン) ことができます!
function appendHeadingDirectly() {
var doc = DocumentApp.openById("YOUR_DOCUMENT_ID");
var body = doc.getBody();
// 1行で「段落の追加」と「見出し設定」を同時に行う!
body.appendParagraph("特記事項・キャンセル規定")
.setHeading(DocumentApp.Heading.HEADING3);
doc.saveAndClose();
}
コードが非常にスッキリし、テンプレートへの動的見出し追加がとてもスムーズになります!
応用②:特定記号(「■」など)で始まる段落を自動で見出し化する
実際の業務では、文章中の「■ ご請求金額」「■ お支払期限」のように 先頭に記号がついている行を自動判別して見出し化したい 場面が多々あります。
JavaScriptの .indexOf() や .startsWith() を使うとスマートに自動化できます!
function autoHeadingBySymbol() {
var doc = DocumentApp.openById("YOUR_DOCUMENT_ID");
var body = doc.getBody();
var paragraphs = body.getParagraphs();
for (var i = 0; i < paragraphs.length; i++) {
var p = paragraphs[i];
var text = p.getText();
// 「■」から始まる段落を自動で見出し2にする
if (text.indexOf("■") === 0) {
p.setHeading(DocumentApp.Heading.HEADING2);
}
}
doc.saveAndClose();
}
このプログラムを組んでおけば、人間が文章を書くときに「■」を付けるだけで、後からGASが一括で見出し装飾を整えてくれます。
応用③:見出し設定を解除して「通常テキスト(NORMAL)」に戻す
間違えて見出しにしてしまった段落や、テンプレートのスタイルを初期化したい場合は、DocumentApp.Heading.NORMAL を渡します。
// 見出しスタイルを解除して、一般的な本文テキストに戻す
paragraph.setHeading(DocumentApp.Heading.NORMAL);
5. 初心者が絶対につまずく!5大トラップと完全対処法
Paragraph.setHeading() を使う際、プログラミング初心者やGAS学習者が非常によく遭遇するエラーやトラブルを5つ厳選しました!
トラップ1:DocumentApp.Heading.HEADING2 の綴りミス(タイポ)
初心者事故率No.1のミスです!
// ✕ NGな書き方(エラーになります)
p.setHeading(DocumentApp.Heading.HEADING_2); // アンダーバーは不要
p.setHeading(DocumentApp.Heading.Heading2); // すべて大文字で書く
// ◯ 正しい書き方
p.setHeading(DocumentApp.Heading.HEADING2);
HEADING1 や HEADING2 などの定数は、すべて半角大文字でアンダーバーなし で記述します。間違えると Cannot read property of undefined といったエラーが発生します。
トラップ2:body.setHeading() と書いて TypeError になる
// ✕ エラーになる書き方
body.setHeading(DocumentApp.Heading.HEADING1);
// エラーメッセージ: TypeError: body.setHeading is not a function
setHeading() は Body(部屋)の命令ではなく、Paragraph(段落・家具)の命令 です! 必ず body.getParagraphs() や body.appendParagraph() で段落を取り出してから、段落に対して呼び出してください。
トラップ3:文字列で "HEADING2" と渡してしまう
// ✕ エラーになる書き方(文字列として渡している)
p.setHeading("HEADING2");
カッコ内にそのまま引用符で囲んだ文字列 "HEADING2" を渡すと型不一致エラーになります。必ず DocumentApp.Heading.HEADING2 という定数の形で渡しましょう。
トラップ4:setHeading() を実行したのに文字の大きさが変わらない?
過去の手動操作で 「特定文字だけに個別でフォントサイズ20ptを設定していた」 ような場合、setHeading() を実行しても見出しスタイルより個別の直接装飾が優先されてしまい、意図した見た目にならないことがあります。
その場合は、次回以降に学ぶ setFontSize(null) や装飾クリアを活用するか、事前にテキストの個別装飾をリセットしておきましょう。
トラップ5:概要(アウトライン)や目次機能との連動ルール
Google ドキュメントでは、setHeading() で設定された見出し(HEADING1〜6)が 自動的にドキュメント左側のアウトライン(概要)や「目次」機能へ反映 されます。
「標準テキスト(NORMAL)」のまま文字サイズだけを大きくしてもアウトラインには表示されません。ドキュメントの全体構造をわかりやすく管理するためにも、文字拡大ではなく setHeading() を使用するのがベストプラクティスです!
6. まとめ&次回予告
今回は、Google ドキュメントの段落に見出しスタイルを設定する Paragraph.setHeading() を徹底解説しました!
今日の重要ポイントおさらい
Paragraph.setHeading()は段落に見出しスタイルを適用する命令- 引数には
DocumentApp.Heading.HEADING2などの定数を指定する BodyではなくParagraphオブジェクトに対して呼び出す- 見出し設定を行うと、Google ドキュメントの概要(アウトライン)に自動反映される
これで、請求書や報告書などのテキストを自動で構造化し、一目でわかりやすい文書に仕立て上げる技術が身につきましたね!
さて、見出しで文書の構造を整えたら、次にやりたくなるのは 「特定の文字(請求合計金額など)をパッと目立つ大きなサイズにしたり、強調カラーで着色すること」 ですよね!
次回(第55回)は、文字のサイズや色を自由自在に装飾できる Paragraph.setFontSize() / setForegroundColor() を解説します!
請求合計金額を一瞬でデカ文字&強調カラーに変身させる実践テクニックを学びましょう!お楽しみに!
