【GAS入門#59】請求書にヘッダー・フッターとページ番号を自動追加!Document.addHeader() / addFooter()の使い方

前回までの連載(第51回〜第58回)では、Googleドキュメントを使った「札幌オフィスの請求書自動生成」を中心に、文字の置換、見出しの設定、フォント装飾、明細表(テーブル)の作成、そして社印画像の挿入まで解説してきました。

請求書の本文はほぼ完成に近づいていますが、実務で提出する公式な書類として、もうひとつ欠かせない要素があります。それが「ヘッダー(用紙の上部余白エリア)」と「フッター(用紙の下部余白エリア)」です!

「会社名や問い合わせ窓口を全ページの上部・下部に表示させたい」 「『1 / 2 ページ』のようなページ番号を自動でフッターに入れたい」

手動で1ページずつ入力するのは大変ですし、ページが増えたときにページ番号がズレてしまう原因にもなります。

そこで第59回となる今回は、Googleドキュメントにヘッダー・フッター枠を自動で作成し、問い合わせ窓口や動的なページ番号を挿入できる必須命令 Document.addHeader() と Document.addFooter() を徹底解説します!

初心者の方が絶対につまずく「既存のヘッダーがある場合のエラー対策」や「ページ番号を動的に表示するテクニック」まで、どこよりも分かりやすく丁寧に解説していきます。

1. そもそも Document.addHeader() / addFooter() とは?

Document.addHeader() と Document.addFooter() は、Googleドキュメントの文書全体に対して、それぞれ「ヘッダー(HeaderSection)」と「フッター(FooterSection)」のエリアを新しく作成・取得するための命令(メソッド)です。

「家・部屋・家具」の例えで理解する位置づけ

本連載でおなじみの「家・部屋・家具」の例えで、Googleドキュメントの構造を整理してみましょう。

  • 【家】= ドキュメント全体(Document)
    • DocumentApp.openById() で開いたドキュメントファイル全体です。
  • 【部屋】= 各エリアセクション(Body / HeaderSection / FooterSection)
    • 本文エリア(Body):文章や表、画像が入るメインの部屋。
    • ヘッダー部屋(HeaderSection):用紙の上部余白に位置する特別な部屋。★今回の主役!
    • フッター部屋(FooterSection):用紙の下部余白に位置する特別な部屋。★今回の主役!
  • 【家具】= 段落(Paragraph)や文字、ページ番号
    • 各部屋の中に置く「文章」「ロゴ」「ページ番号」などの要素です。

普段私たちが操作している body.appendParagraph() などは「本文(Body)」という部屋の中の操作でした。 今回の addHeader() や addFooter() は、ドキュメント全体(家)に対して「上と下に専用の枠組み(別室)を作り出す」操作にあたります。

ヘッダー・フッターの基本文法

// 1. ドキュメント(家)を開く
var doc = DocumentApp.openById("ドキュメントID");

// 2. ヘッダーエリア(上部の部屋)を作成・取得する
var header = doc.addHeader();

// 3. フッターエリア(下部の部屋)を作成・取得する
var footer = doc.addFooter();

ここで作成した header や footer は、本文の body とほぼ同じように .appendParagraph() でテキストを追加したり、フォントサイズや文字の配置(左寄せ・右寄せ・中央揃え)を変更したりできます。

2. STEP1:準備!「札幌オフィスの請求書ドキュメント」を用意しよう

まずは、今回GASから操作するための練習用ドキュメントを用意しましょう。

第51回〜第58回で作成してきた「札幌オフィスの請求書テンプレート」がある方はそちらをご使用ください。手元にない方は、以下の手順で新規作成して準備しましょう。

手順

  1. Googleドライブで新しいGoogleドキュメントを作成し、タイトルを 「【札幌オフィス】請求書テンプレート」 にします。
  2. 本文の中に以下のような簡単なサンプルテキストを入力しておきます。
請求書

発行日: 2026年9月23日
請求先: 株式会社北海道ソリューションズ 御中

ご請求金額: ¥154,000 (税込)

いつもお世話になっております。下記の通りご請求申し上げます。
(※第56回〜第58回で作成した明細表や社印画像がここに入るイメージです)
  1. ドキュメントのIDを取得する ブラウザのアドレスバーに表示されているURLから、/d/ と /edit の間にある長い英数字の文字列(ドキュメントID)をコピーしておきます。
https://docs.google.com/document/d/【ここの英数字がドキュメントID】/edit

3. STEP2:【実践】ヘッダーとフッターを追加するプログラムを動かしてみよう!

準備ができたら、GASのエディタを開いて実際にコードを書いてみましょう!

今回は、札幌オフィスの請求書に対して以下の2つを自動設定します。

  1. ヘッダー(上部):右寄せで 【札幌オフィス公式請求書】 というラベルを表示
  2. フッター(下部):中央揃えで 札幌オフィス問合せ窓口:011-XXX-XXXX | support@sapporo.example.com と表示

1. コードを入力する

スプレッドシートや独立したGASエディタ(script.google.com)を開き、以下のコードを貼り付けます。 ※ YOUR_DOCUMENT_ID の部分は、STEP1で取得したご自身のドキュメントIDに書き換えてください。

function addInvoiceHeaderAndFooter() {
  // ① ドキュメントIDを指定してファイル(家)を開く
  var docId = "YOUR_DOCUMENT_ID"; // ★ご自身のIDに変更してください
  var doc = DocumentApp.openById(docId);
  
  // ② ヘッダーセクションを取得(存在しなければ新規作成)
  var header = doc.getHeader();
  if (!header) {
    header = doc.addHeader();
  } else {
    header.clear(); // すでに存在する場合は中身を一度きれいにする
  }
  
  // ③ ヘッダーにテキストを追加し、右寄せ&フォント指定
  var headerPara = header.appendParagraph("【札幌オフィス公式請求書】");
  headerPara.setAlignment(DocumentApp.HorizontalAlignment.RIGHT);
  headerPara.setFontSize(9);
  headerPara.setForegroundColor("#666666"); // グレー色
  
  // ④ フッターセクションを取得(存在しなければ新規作成)
  var footer = doc.getFooter();
  if (!footer) {
    footer = doc.addFooter();
  } else {
    footer.clear(); // すでに存在する場合は中身を一度きれいにする
  }
  
  // ⑤ フッターに問合せ窓口のテキストを追加し、中央揃え
  var footerPara = footer.appendParagraph("札幌オフィス問合せ窓口:011-XXX-XXXX | support@sapporo.example.com");
  footerPara.setAlignment(DocumentApp.HorizontalAlignment.CENTER);
  footerPara.setFontSize(9);
  footerPara.setForegroundColor("#333333");
  
  // ⑥ 完了ログを出力
  Logger.log("ヘッダーとフッターの追加が完了しました!");
}

2. コードを1行ずつ徹底分解解説!

プログラミング初心者の方に向けて、主要な処理を1行ずつ解説します。

  • var header = doc.getHeader(); if (!header) { header = doc.addHeader(); }
    • ここがプロの現場でも使われる超重要テクニックです!
    • Google Apps Scriptの仕様上、すでにヘッダーが存在するドキュメントに対して直接 doc.addHeader() を実行すると、「Header already exists(すでにヘッダーが存在します)」というエラーが発生してプログラムが止まってしまいます。
    • そのため、まず getHeader() で既存のヘッダーがあるか確認し、無ければ addHeader() で新規作成し、有れば header.clear() で一度中身をリセットするという安全な分岐を組んでいます。
  • header.appendParagraph("【札幌オフィス公式請求書】");
    • ヘッダーセクション(部屋)の中に、新しい段落(家具)を追加してテキストを書き込んでいます。
  • headerPara.setAlignment(DocumentApp.HorizontalAlignment.RIGHT);
    • テキストの配置を右寄せに設定しています。(中央揃えは CENTER、左寄せは LEFT)
  • headerPara.setFontSize(9); / setForegroundColor("#666666");
    • ヘッダー文字が主張しすぎないよう、第55回で学んだ装飾テクニックを使って「小さめの9pt」「グレー色」に設定しています。

3. 保存して実行する

  1. エディタ上部の 「保存アイコン(フロッピーディスク)」 を押します。
  2. 実行する関数が addInvoiceHeaderAndFooter になっていることを確認し、「実行」 ボタンをクリックします。
  3. 初回実行時はGoogleアカウントの承認画面が出ますので、アクセスを許可してください。(第2回参照)

【実行結果の確認】 Googleドキュメントの画面を開いて確認してみましょう!

  • ページの上部余白エリアに、右寄せで灰色(グレー)の 【札幌オフィス公式請求書】 が追加された!
  • ページの下部余白エリアに、中央揃えで 札幌オフィス問合せ窓口:011-XXX-XXXX | support@sapporo.example.com が追加された!

本文のレイアウトを崩すことなく、書類の上下に綺麗な枠線上の情報が整然と配置されましたね!

4. STEP3:実務で差がつく!ヘッダー・フッターの発展テクニック3選

単に固定の文字を入れるだけでなく、実際のビジネス現場で絶対に使う「3つの応用テクニック」を押さえておきましょう。

応用①:appendPageNumber() で「動的なページ番号」を自動挿入する

複数ページにわたる請求書や契約書、報告書で最も求められるのが「ページ番号(ページ 1 / 2 など)」の挿入です。

GASのドキュメント操作には、ページ番号を動的に出力するための専用メソッド appendPageNumber() と appendPageCount() が用意されています!

function addPageNumberToFooter() {
  var doc = DocumentApp.openById("YOUR_DOCUMENT_ID");
  
  // フッターを取得または作成
  var footer = doc.getFooter() || doc.addFooter();
  footer.clear(); // 中身をリセット
  
  // 段落を作成(中央揃え)
  var para = footer.appendParagraph("");
  para.setAlignment(DocumentApp.HorizontalAlignment.CENTER);
  para.setFontSize(9);
  
  // ① 「ページ 」というテキストを追加
  para.appendText("ページ ");
  
  // ② 現在のページ番号(1, 2, 3...)を動的に挿入!
  para.appendPageNumber();
  
  // ③ 「 / 」を追加
  para.appendText(" / ");
  
  // ④ 全体ページ数(例: 2)を動的に挿入!
  para.appendPageCount();
}

ここがポイント!

単に para.appendText("1") と書くと、全ページに数字の「1」が固定で印字されてしまいます。 しかし、para.appendPageNumber() を使って挿入された要素は、Googleドキュメントが「現在のページ数」を自動計算して表示してくれる特殊なフィールドになります。そのため、2ページ目には自動で「2」、3ページ目には「3」と正しく切り替わります!

応用②:フッターに「問合せ窓口」と「ページ番号」を左右両端に配置する(表を活用した裏技)

「フッターの左側に問合せ窓口を書き、右側にページ番号を並べて表示したい!」というレイアウトの要望はよくあります。

しかし、普通に文字を書くと左寄せか右寄せのどちらかしか選べません。 これを解決するプロの裏技が、「枠線透明の1行2列の表(Table)をフッターの中に挿入する」 テクニックです!

function addTwoColumnFooter() {
  var doc = DocumentApp.openById("YOUR_DOCUMENT_ID");
  var footer = doc.getFooter() || doc.addFooter();
  footer.clear();
  
  // 1行2列の透明な表をフッターの中に作成する
  var table = footer.appendTable([
    ["札幌オフィス問合せ窓口: 011-XXX-XXXX", ""]
  ]);
  
  // 表の枠線(罫線)を消して透明にする
  table.setBorderWidth(0);
  
  // 左側のセル(0列目)のテキスト設定
  var leftCell = table.getCell(0, 0);
  leftCell.getChild(0).asParagraph().setFontSize(8).setForegroundColor("#666666");
  
  // 右側のセル(1列目)にページ番号を設定(右寄せ)
  var rightCell = table.getCell(0, 1);
  var rightPara = rightCell.getChild(0).asParagraph();
  rightPara.setAlignment(DocumentApp.HorizontalAlignment.RIGHT);
  rightPara.setFontSize(8);
  rightPara.setForegroundColor("#666666");
  
  rightPara.appendText("Page ");
  rightPara.appendPageNumber();
  rightPara.appendText(" of ");
  rightPara.appendPageCount();
}

このコードを実行すると、フッターの左端に問い合わせ窓口、右端に Page 1 of 2 という美しく洗練されたレイアウトが完成します。第56回・57回で学んだ表操作の技術がここでも大活躍しますね!

応用③:ヘッダーに罫線(区切り線)を引いて本文と区切る

ヘッダーの文字の下に横線(水平線)を一本引くだけで、書類全体のデザインがグッと引き締まります。

function addHeaderWithHorizontalLine() {
  var doc = DocumentApp.openById("YOUR_DOCUMENT_ID");
  var header = doc.getHeader() || doc.addHeader();
  header.clear();
  
  // ヘッダーテキストの追加
  var para = header.appendParagraph("札幌オフィス 発行書類");
  para.setFontSize(9).setForegroundColor("#444444");
  
  // ヘッダーの末尾に水平線(HorizontalRule)を挿入する
  header.appendHorizontalRule();
}

header.appendHorizontalRule() を呼び出すだけで、本文との境目に美しいスタイリッシュな区切り線が自動挿入されます。

5. 初心者が絶対につまずく!5大トラップと解決策

Document.addHeader() / addFooter() を扱う際に、プログラミング初心者やGAS学習者がよく遭遇するエラーや落とし穴を5つ厳選しました。あらかじめ確認しておきましょう!

トラップ1:Exception: Header already exists と怒られてプログラムが止まる

【原因】

すでにヘッダーが存在するドキュメントに対して、無条件で doc.addHeader() を何度も呼び出してしまうと発生するGASの仕様上のエラーです。

【解決策】

前述の通り、必ず getHeader() で確認してから無ければ addHeader() を呼ぶ という安全なコードを書きましょう!

// ◯ 正しい安全な書き方
var header = doc.getHeader() || doc.addHeader();

トラップ2:body.addHeader() と書いて TypeError になる

【原因】

addHeader() や addFooter() を、本文である body オブジェクトに対して実行しようとしてしまうミスです。

// ✕ エラーになる書き方
var body = doc.getBody();
var header = body.addHeader(); // TypeError: body.addHeader is not a function

【解決策】

ヘッダーやフッターは「ドキュメント全体」に属するエリアです。必ず doc(Documentオブジェクト) に対して呼び出してください。

// ◯ 正しい書き方
var header = doc.addHeader();

トラップ3:実行するたびにヘッダー内に同じ文字が何重にも追加されてしまう

【原因】

addHeader() や getHeader() で取得したエリアに対して、.appendParagraph() だけを何度も繰り返し実行すると、古い段落が残ったまま下にどんどん新しい文字が追記されてしまいます。

【解決策】

ヘッダー・フッターの中身を新しくセットし直したい時は、処理の冒頭で header.clear() を実行して古い要素を綺麗にリセットしてからテキストを追加しましょう!

トラップ4:ページ番号が単なる「1」と印字され、2ページ目も「1」のままになる

【原因】

ページ番号を挿入する際、以下のように固定の文字列として「1」を書き込んでしまっているケースです。

// ✕ 間違った書き方(固定文字)
para.appendText("ページ 1");

【解決策】

動的にページ数を計算させるには、必ず para.appendPageNumber() という専用のメソッドを使って動的フィールドとして挿入してください。

トラップ5:1ページ目だけヘッダー・フッターを非表示にしたいのに消えない

契約書や報告書などで「表紙(1ページ目)にはヘッダー・フッターを出さず、2ページ目から表示させたい」というケースがありますよね。

Googleドキュメントには「最初のページのみ別指定」という設定があります。GASからこれを制御するには以下の命令を使います。

// 1ページ目のヘッダー/フッターを別設定(非表示等)にする設定
doc.setDifferentFirstPageHeaderFooter(true);

この1行を追加すると、1ページ目のヘッダー・フッターが独立し、表紙デザインを綺麗に保つことができます。

6. まとめ&次回予告

今回は、Googleドキュメントにヘッダー・フッターと動的なページ番号を追加する Document.addHeader() / addFooter() について徹底解説しました。

今日の重要ポイントおさらい

  1. addHeader() / addFooter() はドキュメント全体(doc)に対して呼び出す
  2. すでに存在する場合のエラーを防ぐため doc.getHeader() || doc.addHeader() のパターンを使う
  3. 中身を更新するときは header.clear() で一度リセットしてから追加する
  4. ページ番号は appendPageNumber() と appendPageCount() を使って動的に挿入する
  5. 左右に要素を振り分けたいときは、フッター内に「透明な表(Table)」を作る裏技が有効

これで、札幌オフィスの請求書ドキュメントは見た目もレイアウトも完全なプロ仕様として完成しました!

次回予告

次回(第60回)はいよいよ、Googleドキュメント操作編(フェーズ6)の感動の最終回です!

テーマは Document.getAs('application/pdf') × 完成した請求書をPDFに自動変換してDriveに保存 です!

今回までで完璧に作り上げたGoogleドキュメントの請求書を、編集不可能な「PDFファイル」に一瞬で自動変換し、指定したGoogleドライブのフォルダへ自動保存する全自動ラインを完成させます。ぜひお楽しみに!