【GAS入門#57】TableCell.setText() / setBackgroundColor()でドキュメント明細表のセルに動的データを入力&背景色を着色しよう!

前回(第56回)は、Google Apps Script(GAS)を使ってGoogleドキュメント内に新しい表(テーブル)を追加する Body.appendTable() について解説しました。

表の枠組み(グリッド)を作成できるようになりましたが、まだ表の中身は空っぽだったり、見た目が少し素っ気ない状態ですよね。請求書や見積書、業務レポートを作成する際、「ヘッダー行にコーポレートカラーを着色しておしゃれにしたい」「明細データをプログラムから動的に流し込みたい」 という場面が必ず出てきます。

そこで第57回となる今回は、Googleドキュメントの表(Table)の中にある1つひとつのマス目(セル)を自由自在に操作する2大必須メソッド TableCell.setText() と TableCell.setBackgroundColor() を徹底解説します!

今回も「札幌オフィスの請求書作成」を題材に、実際のコード例やハマりやすい注意点、配列を使った自動流し込みテクニックまで、どこよりも分かりやすく丁寧に紐解いていきますね!

1. そもそも TableCell(テーブルセル)とは?

まずは、Googleドキュメントにおける「表」の構造を理解しておきましょう。

スプレッドシートでは Range や Cell という概念を使いましたが、Googleドキュメントの表は以下のような階層構造(親子関係)になっています。

  • Document(ドキュメント全体)
    • Body(本文エリア)
      • Table(表全体)
        • TableRow(行:横一列)
          • TableCell(セル:1つのマス目)★今回の主役!

つまり、ドキュメントの表にある特定のマス目にアクセスするためには、「表(Table) ➡ 行(TableRow) ➡ セル(TableCell)」 という順番で順番にたどっていく必要があります。

本日覚える2つの基本メソッド

① TableCell.setText(“表示したい文字”)

指定したセルの中にテキストをセット(書き込み)する命令です。 セル内にすでに文字が入っている場合は、自動的に新しい文字へ上書きされます。

② TableCell.setBackgroundColor(“#1A365D”)

指定したセルの背景色(カラー)を変更する命令です。 Web制作やデザインでおなじみのカラーコード(HEX:"#FF0000" や "#1A365D" など)を使って、自由にセルを着色できます。

2. STEP1:準備!「札幌オフィス請求書」の土台を用意しよう

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

手順

  1. Googleドライブで新しいGoogleドキュメントを作成します。
  2. ドキュメントのタイトルを 「【札幌オフィス】ご請求書テンプレート」 に変更します。
  3. ドキュメントの本文に「ご請求明細」と見出しを入れておきます。
  4. ブラウザのURL欄から、ドキュメントID(https://docs.google.com/document/d/【ここの文字列】/edit)をメモしておきます。

3. STEP2:【実践】表を作成し、ヘッダーの着色&データを流し込もう!

それでは、実際にGASのエディタを開いてコードを書いていきましょう!

今回は、以下の3つのステップをGASで自動化してみます。

  1. 3行4列の表(テーブル)を作成する
  2. 1行目(ヘッダー行)の背景色を「ネイビー(#1A365D)」に着色し、文字を入力する
  3. 2行目・3行目に「札幌オフィスの作業明細データ」を動的に流し込む

1. コードを入力する

GoogleスプレッドシートまたはスタンドアロンのGASエディタ(またはドキュメントの「拡張機能」>「Apps Script」)を開き、以下のコードを貼り付けます。

※ YOUR_DOCUMENT_ID の部分には、ご自身のGoogleドキュメントのIDを貼り付けてください。

function createInvoiceTable() {
  // ① ドキュメントを開いてBody(本文)を取得する
  var docId = "YOUR_DOCUMENT_ID"; // ご自身のドキュメントIDに差し替えてください
  var doc = DocumentApp.openById(docId);
  var body = doc.getBody();

  // ② 3行4列の空の明細表を作成する(第56回の復習)
  var tableData = [
    ["品名・作業内容", "数量", "単価", "金額(税込)"],
    ["", "", "", ""],
    ["", "", "", ""]
  ];
  var table = body.appendTable(tableData);

  // --------------------------------------------------
  // ③ ヘッダー行(0行目)のデザイン設定と文字入力
  // --------------------------------------------------
  var headerRow = table.getRow(0); // 1行目(インデックス0)を取得
  
  // ヘッダーの背景色(ダークネイビー)
  var headerBgColor = "#1A365D";

  for (var col = 0; col < 4; col++) {
    var cell = headerRow.getCell(col);
    // 背景色を着色!
    cell.setBackgroundColor(headerBgColor);
    
    // ヘッダー文字の見た目を整える(文字色を白、太字に設定)
    var textNode = cell.editAsText();
    textNode.setForegroundColor("#FFFFFF");
    textNode.setBold(true);
  }

  // --------------------------------------------------
  // ④ 2行目・3行目に札幌オフィスの明細データを流し込む
  // --------------------------------------------------
  
  // 1行目の作業明細(札幌スープカレーECサイト改修作業)
  table.getRow(1).getCell(0).setText("札幌スープカレーEC機能改修作業");
  table.getRow(1).getCell(1).setText("1 式");
  table.getRow(1).getCell(2).setText("¥150,000");
  table.getRow(1).getCell(3).setText("¥165,000");

  // 2行目の作業明細(札幌データセンター サーバー保守費用)
  table.getRow(2).getCell(0).setText("札幌データセンター月次保守費用(10月分)");
  table.getRow(2).getCell(1).setText("1 か月");
  table.getRow(2).getCell(2).setText("¥50,000");
  table.getRow(2).getCell(3).setText("¥55,000");

  // ⑤ 変更を保存してドキュメントを更新
  doc.saveAndClose();
  
  Logger.log("請求書明細表の作成・着色・データ流し込みが完了しました!");
}

2. 実行結果を確認する

コードを入力して保存し、「実行」ボタンを押してみましょう。

指定したGoogleドキュメントを開くと……!

  • ヘッダー行(品名・数量・単価・金額)の背景が渋いネイビーに塗られ、文字が白太字で強調されている!
  • 2行目・3行目に「札幌スープカレーEC機能改修作業」や「札幌データセンター月次保守費用」といった明細データが綺麗に入力されている!

美しく整った明細表が一瞬で自動生成されましたね!

4. STEP3:コードの仕組みを1行ずつ徹底分解解説!

初心者の方がつまずかないよう、重要な部分を1行ずつ分解して解説していきます。

1. table.getRow(rowIndex)

表(table)から特定の行(TableRow)を取り出します。 ここで最も重要なポイントは、プログラミングの世界でおなじみの 「0始まり(インデックス)」 であることです!

  • table.getRow(0) ➡ 1行目(ヘッダー行)
  • table.getRow(1) ➡ 2行目(明細1行目)
  • table.getRow(2) ➡ 3行目(明細2行目)

2. row.getCell(columnIndex)

取得した行(row)から、特定の位置にあるマス目(TableCell)を取り出します。 こちらも 0始まり となります。

  • row.getCell(0) ➡ 1列目(A列相当:品名)
  • row.getCell(1) ➡ 2列目(B列相当:数量)
  • row.getCell(2) ➡ 3列目(C列相当:単価)
  • row.getCell(3) ➡ 4列目(D列相当:金額)

したがって、table.getRow(1).getCell(0) と書くと、「表の2行目・1列目のセル」をピンポイントで指定できるわけです!

3. cell.setBackgroundColor("#1A365D")

指定したセルに対して背景色をセットします。 カラーコードは、シャープ(#)から始まる6桁の16進数文字列で指定します。

4. cell.setText("表示テキスト")

指定したセルに文字列を流し込みます。 とてもシンプルな命令ですが、セル内の既存テキストを置き換えて素早く入力できるため、データ流し込みの主役として大活躍します。

5. STEP4:実務で差がつく!2次元配列×ループ処理での自動流し込み

先ほどのコードでは getRow(1).getCell(0).setText(...) と1セルずつ手動で書きましたが、明細が10行や20行になったときに手書きするのは大変ですよね。

実務では、スプレッドシートや外部データから取得した 「2次元配列」 をループ処理(for文)でぐるぐる回して、自動的にテーブルへ流し込むのがプロの書き方です!

スマートな応用コードを見てみましょう。

function generateDynamicInvoice() {
  var doc = DocumentApp.getActiveDocument(); // アクティブなドキュメントを取得
  var body = doc.getBody();

  // 流し込みたい動的明細データ(2次元配列)
  var items = [
    ["札幌スープカレーEC機能改修作業", "1 式", "¥150,000", "¥165,000"],
    ["札幌データセンター月次保守費用(10月分)", "1 か月", "¥50,000", "¥55,000"],
    ["札幌オフィス Wi-Fi6ルーター設置・設定作業", "2 台", "¥25,000", "¥55,000"],
    ["北海道特産品カタログデザイン制作", "1 式", "¥80,000", "¥88,000"]
  ];

  // ヘッダー+データ行数分のテーブル枠を作成
  var table = body.appendTable();
  
  // 1. ヘッダー行を作成・デザイン
  var headerRow = table.appendTableRow();
  var headers = ["品名・作業内容", "数量", "単価", "金額(税込)"];
  
  for (var h = 0; h < headers.length; h++) {
    var cell = headerRow.appendTableCell(headers[h]);
    cell.setBackgroundColor("#2B6CB0"); // 明るめのブルー
    
    // 文字の装飾
    var textNode = cell.editAsText();
    textNode.setForegroundColor("#FFFFFF");
    textNode.setBold(true);
  }

  // 2. ループ処理で明細データを1行ずつ自動追加!
  for (var i = 0; i < items.length; i++) {
    var rowData = items[i]; // 1行分のデータ配列
    var row = table.appendTableRow();
    
    for (var j = 0; j < rowData.length; j++) {
      var cell = row.appendTableCell(rowData[j]);
      
      // 偶数行と奇数行で背景色を交互に変える(ゼブラ柄装飾!)
      if (i % 2 === 1) {
        cell.setBackgroundColor("#F7FAFC"); // 薄いグレー
      }
    }
  }

  Logger.log("動的明細表の自動生成が完了しました!");
}

ここがスゴい!応用テクニックのポイント

  • ゼブラ柄(しましま模様)の自動装飾:if (i % 2 === 1) を使うことで、偶数行にだけ薄いグレーの背景色をつけて視認性を劇的に高めています!
  • 行数の自動追従:items 配列の要素数が増減しても、コードを一切書き換えることなく自動でピッタリの表が完成します。

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

TableCell を操作する際、初心者が特によく遭遇するエラーや落とし穴を5つ厳選して解説します。

トラップ1:行・列の指定を「1始まり」だと勘違いしてしまう

スプレッドシートの感覚で「1行目・1列目だから getRow(1).getCell(1)」と書くと、実際には「2行目・2列目」のセルが選択されてしまいます!

  • ✕ getRow(1) ➡ 実際は 2行目
  • ◯ getRow(0) ➡ これが 1行目(先頭行)

配列やGoogleドキュメントのインデックスは 必ず 0 からスタートする ことを忘れないようにしましょう!

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

スプレッドシートの癖でついつい書いてしまいがちなのがこちらです。

// ✕ エラーになる書き方
cell.setValue("テキスト"); 
// TypeError: cell.setValue is not a function

Googleドキュメントの TableCell には setValue() というメソッドは存在しません。 文字を入力するときは setText() を使うのが正解です。

トラップ3:TableCell に対して直接 setFontSize() を呼んでしまう

セルの背景色は cell.setBackgroundColor() で直接設定できますが、文字サイズや文字色は TableCell 自体には設定できません。

// ✕ エラーになる書き方
cell.setFontSize(12);

// ◯ 正しい書き方(editAsText() を経由する)
cell.editAsText().setFontSize(12);

セルの「中身の文字(テキスト)」を装飾したい場合は、必ず cell.editAsText() を呼び出してからフォントや色を変更しましょう。

トラップ4:カラーコードの # を忘れる / 16進数のタイポ

背景色の指定で # を付け忘れたり、存在しないカラーコードを指定するとエラーになります。

  • ✕ cell.setBackgroundColor("1A365D"); (# がない)
  • ◯ cell.setBackgroundColor("#1A365D"); (正解)

トラップ5:セルを追加しすぎて表のレイアウトが崩れる

appendTableCell() を繰り返し呼び出す際、特定の行だけ列数が多くなってしまうと、表全体の幅が不揃いになって崩れる原因になります。

全行で列数(セル数)が揃うように配列の要素数をしっかり管理しましょう。

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

今回は、Googleドキュメントの表(テーブル)のセルにデータを流し込み、背景色を着色する TableCell.setText() と TableCell.setBackgroundColor() を詳しく解説しました。

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

  1. 表の階層構造は Table ➡ TableRow ➡ TableCell の順番!
  2. 行や列の番号指定は「0始まり(インデックス0)」を意識する
  3. cell.setText("文字") でセルのテキストをセットできる
  4. cell.setBackgroundColor("#1A365D") でヘッダーやゼブラ柄の背景色を着色できる
  5. 文字色の変更や太字化には cell.editAsText() を経由する

これで、Googleドキュメント内に見栄えの良い美しい明細表を自動生成できるようになりましたね!

さて、請求書の本文と明細表が完成したら、最後に欲しくなるのが 「会社の角印(社印)画像」 ですよね!

次回(第58回)は、Body.appendImage() を解説します!

画像のサイズ調整や配置のテクニックをマスターして、完全自動の請求書発行システムを完成させましょう!お楽しみに!