【GAS入門#56】Googleドキュメントに表を自動挿入!Body.appendTable()の使い方と2次元配列でのテーブル作成を徹底解説

前回(第55回)は、Paragraph.setFontSize() や setForegroundColor() を使って、Googleドキュメント内の請求合計金額などの文字サイズを大きくしたり、赤色で強調装飾したりする方法を解説しました。ドキュメントにメリハリがつくと、一気に書類としての完成度が高まりましたね!

さて、見出しやテキストの装飾ができるようになったら、次にやりたくなるのは「綺麗な表(テーブル)を自動で作成して挿入すること」ではないでしょうか?

請求書の見積明細、月次報告書の項目一覧、プロジェクトの作業工程表など、ビジネス文書において「表」は情報を整理して伝えるための主役と言っても過言ではありません。

第56回となる今回は、Googleドキュメントの本文末尾に新しい表をサッと作成・挿入できる超重要メソッド Body.appendTable() を徹底解説します!

「札幌オフィスのWebサイト構築作業明細」を題材に、2次元配列を使った表データの組み立て方から、ドキュメント特有のテーブル構造、初心者が必ずハマる注意点まで、どこよりも分かりやすく噛み砕いてお届けします。今日からGoogleドキュメントの自動生成テクニックを一段上へ引き上げましょう!

1. そもそも Body.appendTable() とは?

Body.appendTable() は、Googleドキュメントの本文(Body オブジェクト)の末尾に、指定したデータで構成された新しい表(Table オブジェクト)を追加・挿入する命令(メソッド)です。

「スプレッドシート」と「Googleドキュメント」の表の違い

GASを学んでいると、「スプレッドシートも表だし、ドキュメントの表も同じじゃないの?」と混同しがちですが、GAS内部での扱い方は大きく異なります。

  • スプレッドシート(SpreadsheetApp):画面全体が元から無限のマス目(Range)でできており、そこへ値を流し込むイメージ(第4回〜第6回参照)。
  • Googleドキュメント(DocumentApp):基本は上から下へ流れる「文章(段落)」の世界。その文章の流れの途中に、ひとつの独立した構造物として「表(Table)」をドカンと設置するイメージ。

まさに、文章の末尾に新しい家具(テーブル)をポンと買い足して設置するような操作にあたります。

基本的な書き方(構文)

// 1. ドキュメントの本文(Body)を取得する
var body = doc.getBody();

// 2. 表にしたい「2次元配列」のデータを用意する
var myData = [
  ["品名", "数量", "単価"],
  ["サーバー構築", "1", "50,000"]
];

// 3. Bodyの末尾に表(テーブル)を追記挿入する
var table = body.appendTable(myData);

1行で body.appendTable(myData); と呼び出すだけで、指定した配列の行数・列数に合わせて自動的に罫線がついた表が作成されます!

2. 理解の鍵!「2次元配列(2D Array)」で表を表現しよう

appendTable() を使いこなすために絶対に必要な知識が、「2次元配列(にじげんはいれつ)」です。

第7回の Sheet.appendRow() の記事で、1行分のデータを ["2026/09/23", "高橋", 1590] のように [ ] (角カッコ)で囲む「お弁当箱(1次元配列)」として学びましたね。

今回の appendTable() では、「お弁当箱(行)をさらに大きなダンボール箱(全体)の中に縦に重ねて詰める」イメージになります!これが「2次元配列」です。

「重ねたお弁当箱」でイメージしてみよう!

var tableData = [
  ["作業品名", "数量", "単価(円)", "金額(円)"], // 1段目(見出し行)
  ["札幌向けWEBデザイン", "1", "150,000", "150,000"],    // 2段目(データ行1)
  ["GAS自動化構築", "2", "50,000", "100,000"]         // 3段目(データ行2)
];
  • 一番外側の [ と ] の中に、カンマ , 区切りで複数の [ ] が入っています。
  • 内側の各 [ ] が「表の1行(横方向)」 を表します。
  • 内側の要素(文字列など)が「各列(セル)」 を表します。

この「ダンボールに詰めたお弁当箱セット」を Body.appendTable() に渡すと、GASは自動的に「3行 × 4列の表」を作り出してくれるのです!

3. STEP1:準備!「札幌オフィスの作業明細ドキュメント」を用意しよう

それでは、実際に手元のGoogleドキュメントを使ってコードを動かす準備をしましょう!

手順

  1. Googleドライブで新しいGoogleドキュメントを作成します。
  2. ドキュメントのタイトルを 「札幌オフィス作業明細書」 に変更します。
  3. 文書の1行目に「ご請求明細書」と入力し、見出しなどに設定しておきます(過去の第53回・第54回で学んだように、本文を作っておきます)。
  4. URLからドキュメントIDを取得します。
    • URLの https://docs.google.com/document/d/ と /edit の間にある長〜い英数字の文字列(例: 1ABC123xyz...)をコピーしておきます(第51回参照)。

4. STEP2:【実践】Body.appendTable() で作業明細表を自動生成してみよう!

準備ができたら、GASのエディタ画面を開いてコードを書いていきましょう。 今回は「札幌オフィスのWebサイト制作・GAS自動化作業」の明細表(5行×4列)をドキュメントの末尾に自動生成します。

1. コードを入力する

Googleドキュメントのメニューバーから 「拡張機能」 > 「Apps Script」 を開き(またはスプレッドシート等のバインドスクリプトから)、以下のコードを貼り付けます。

function createSapporoWorkDetailTable() {
  // ① 対象のGoogleドキュメントをIDで開く(第51回で学んだ命令)
  var docId = "YOUR_DOCUMENT_ID_HERE"; // ★ご自身のドキュメントIDに書き換えてください
  var doc = DocumentApp.openById(docId);
  
  // ② ドキュメントの本文(Body)を取得する
  var body = doc.getBody();
  
  // ③ 表にするデータを「2次元配列」として定義する
  // 札幌オフィスのWebサイト改修&自動化作業の明細データ
  var tableData = [
    ["作業品名", "数量", "単価(円)", "金額(円)"], // ヘッダー行
    ["札幌向けトップページデザイン作成", "1", "150,000", "150,000"],
    ["レスポンシブHTML/CSSコーディング", "1", "100,000", "100,000"],
    ["札幌オフィストピックスGAS自動化", "2", "50,000", "100,000"],
    ["お問い合わせフォーム連携設定", "1", "30,000", "30,000"]
  ];
  
  // ④ Bodyの末尾に表(テーブル)を追加挿入する
  var table = body.appendTable(tableData);
  
  // ⑤ 実行ログで完了を確認する
  Logger.log("札幌オフィスの作業明細表を正常に作成・挿入しました!");
}

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

  • var doc = DocumentApp.openById(docId);
    • 第51回でマスターした命令です。指定したIDのGoogleドキュメントファイルを開きます。
  • var body = doc.getBody();
    • ドキュメントのメイン本文領域(Body)を掴みます。これによって本文への段落追加(appendParagraph)や表追加(appendTable)が可能になります。
  • var tableData = [ ... ];
    • 5行×4列のデータ構造を持つ2次元配列を作成しています。数字もあらかじめ文字列 "150,000" や "1" のように整形しておくと、表にそのまま美しく表示されます。
  • var table = body.appendTable(tableData);
    • 本日の主役です!body に対して .appendTable() を呼び出し、作成した2次元配列 tableData を渡します。これだけで、一瞬にしてドキュメントの最下部にきれいな枠線付きの表が生成されます。

3. 保存して実行してみよう!

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

【実行結果の確認】 Googleドキュメントの画面に戻ってみましょう! 本文の末尾に、5行×4列の「作業品名・数量・単価・金額」が整然と並んだ表が自動で挿入されているはずです!

5. STEP3:実務で差がつく!Googleドキュメントの「表の構造」を理解しよう

appendTable() を実行すると、返り値として Table オブジェクト(変数 table)が返ってきます。

実務で「表の特定のセルの色を変えたい」「文字を中央揃えにしたい」という高度な操作をするためには、Googleドキュメントにおける表の内部階層構造を知っておくことが不可欠です。

Googleドキュメントのテーブル階層構造

Document(ファイル全体)
 └─ Body(本文領域)
     └─ Table(表全体)★ appendTable() で生成される
         └─ TableRow(行:1行目, 2行目...)
             └─ TableCell(セル:マス目)
                 └─ Paragraph(セル内の文章)

HTMLのWeb制作を経験されたことがある方なら、<table> ➡ <tr> ➡ <td> ➡ <p> の構造と全く同じだと気付くかもしれません!

  • Table:表全体をまとめるオブジェクト。
  • TableRow:表の中の「1つの行」。table.getRow(0) で1行目を取得できます。
  • TableCell:行の中の「1つのマス目(セル)」。row.getCell(0) で左端のセルを取得できます。

次回(第57回)では、この構造を使って TableCell.setBackgroundColor() や setText() を呼び出し、見出し行を「札幌ブルー」に着色したり、文字を太字にするテクニックを学んでいきますよ!

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

Body.appendTable() を使う際、プログラミング初心者やGAS学習者が非常によく遭遇するエラーやトラブルを5つ厳選しました。

トラップ1:1次元配列を渡してしまってエラーになる

配列の [ ] を二重にし忘れ、1次元配列のまま渡してしまうケースです。

// ✕ NG:1次元配列(エラーになります)
var badData = ["作業品名", "数量", "単価"];
body.appendTable(badData);

// ◯ OK:2次元配列(外側をもうひとつの [ ] で囲む)
var goodData = [
  ["作業品名", "数量", "単価"]
];
body.appendTable(goodData);

appendTable() は 「行」の集まり を受け取るルールになっています。たとえ1行だけの表を作る場合でも、必ず外側を [ ] で囲んで2次元配列にする必要があります。

トラップ2:SpreadsheetApp(スプレッドシート)の感覚で getRange を使おうとする

「表ができたから、A1セルに文字を書き込もう!」として、table.getRange("A1") や table.getValue() と書いてしまうミスです。

Googleドキュメントの表には「A1」「B2」といったセルの概念や getRange メソッドはありません。セルを指定したい場合は、前述した階層構造を辿って table.getRow(0).getCell(0) のように取得する必要があります。

トラップ3:数値データ(Number)をそのまま渡して型エラーになる

2次元配列の中に、null や特殊なオブジェクト、または処理できない型が混ざっているとエラーを起こすことがあります。

// ✕ トラブルの原因になりやすい書き方
var data = [
  ["商品名", "価格"],
  ["札幌スープカレー", 1200] // 数値を直接入れると環境によって予期せぬ挙動になる場合も
];

// ◯ 最も安全な書き方(すべて文字列化しておく)
var data = [
  ["商品名", "価格"],
  ["札幌スープカレー", "1,200"] // 文字列に統一しておくのがベスト!
];

ドキュメントの表に流し込むデータは、あらかじめ String(val) や toString() を使って文字列(Text)に変換して配列を作っておくのが、エラーを防ぐ最大のコツです。

トラップ4:表が「文章の途中」ではなく常に「一番下」に入ってしまう

appendTable() の「append(アペンド)」には、「末尾に追記する」という意味があります。 そのため、すでに本文の中に文章がたくさんある状態で body.appendTable() を実行すると、必ずドキュメントの最後尾に表が追加されます。

もし「本文の途中(特定の段落の間)」に表を挿入したい場合は、今後学ぶ Body.insertTable(index, tableData) という別の挿入命令を使いますので覚えておきましょう!

トラップ5:実行してもドキュメントの表示が更新されない?

コードを実行して「完了」と出たのに、開いているGoogleドキュメントの画面が変わらないことがあります。

これはGASのバグではなく、ブラウザのキャッシュや同期のタイムラグによるものです。ドキュメントの画面を F5キー(Macは Cmd + R)で再読み込み(リフレッシュ) すると、しっかり表が追加されているのが確認できます。

7. 今回のまとめと次回予告

今回は、Googleドキュメントの本文末尾に表を動的生成する Body.appendTable() を徹底解説しました!

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

  1. Body.appendTable() は、Googleドキュメントの本文末尾に表を新規挿入する命令
  2. 表のデータは「2次元配列 [[行1], [行2]]」(重ねたお弁当箱)の形式で渡す
  3. 流し込むデータはあらかじめ文字列(String)に揃えておくと安全
  4. ドキュメントの表は Table ➡ TableRow ➡ TableCell という階層構造になっている

これで、文章だけでなく「表」という構造化データをドキュメントに自由に自動生成できるようになりましたね!

しかし、デフォルトで挿入された表は白黒で少し味気ないデザインです。請求書や提出書類として使うなら、ヘッダー行を綺麗な会社カラー(例:札幌ブルー)に着色したり、文字を太字に装飾したくなりますよね。

そこで次回(第57回)は、TableCell.setText() / setBackgroundColor() を使って明細表のセルに動的データを流し込み、ヘッダー行を色鮮やかに着色する方法 を解説します!

表のデザインを自由自在にカスタマイズする実践テクニックを学びますので、ぜひお楽しみに!