【GAS入門#68】Googleスライドに表を自動挿入!Slide.insertTable()の使い方と実務活用法

前回(第67回)は、スライド内のテキストボックスにある文字を書き換えたり、フォントサイズや太字を動的に変更する TextRange.setText() や setFontSize() などのテキスト装飾テクニックを学びました。

スライド作成の自動化において、テキストの配置と同じくらい頻繁に発生するのが「表(テーブル)の作成」です。

月次報告書やプロジェクトの進捗レポートを作成する際、毎回手作業で表を挿入し、行数・列数を合わせて、1マスずつ数値を入力していく作業はなかなか骨が折れますよね。

そこで第68回となる今回は、Googleスライド上にプログラムから自動で表を挿入できる Slide.insertTable() を徹底解説します!

今回は「札幌オフィス プロジェクト別売上・コスト推移表」を題材に、スライド内に指定した行数・列数の表を作成し、データを流し込んで綺麗なレポート表を仕上げる方法をどこよりも分かりやすく丁寧に紐解いていきます!

1. そもそも Slide.insertTable() とは?

Slide.insertTable() は、指定したスライド(Slide オブジェクト)の中に 新しい表(Table)を自動挿入する命令(メソッド) です。

基本的なコードの構文

Slide.insertTable() には、大きく分けて 2つの書き方(構文) が用意されています。

パターン①:行数と列数のみ指定する(スライド中央付近に標準サイズで配置)

// 3行4列の表を自動挿入する
var table = slide.insertTable(3, 4);

パターン②:位置(座標)とサイズもまとめて指定する【実務でおすすめ!】

// 3行4列の表を、位置(left, top)とサイズ(width, height)を指定して挿入する
var left = 50;    // 左からの位置(ポイント)
var top = 100;    // 上からの位置(ポイント)
var width = 600;  // 表の幅(ポイント)
var height = 200; // 表の高さ(ポイント)

var table = slide.insertTable(3, 4, left, top, width, height);

ドキュメント編(第56回 appendTable)との違い

本連載の第56回で学んだ Google ドキュメントの表挿入(Body.appendTable())を覚えているでしょうか?

ドキュメントとスライドでは、表を追加する際の考え方が少し異なります。

項目Google ドキュメント(第56回)Google スライド(今回:第68回)
挿入メソッドBody.appendTable()Slide.insertTable()
配置の仕組み文章の流れに沿って上から下へ流し込むスライド上の 指定した座標(位置・サイズ) に配置する
自由度ページの本文内に順番に配置されるキャンバス上の好きな位置にピンポイント配置可能

スライドは「キャンバス上に要素を自由にレイアウトする」仕組みになっているため、位置(left, top)やサイズ(width, height)を細かくコントロールできるのが Slide.insertTable() の大きな特徴です。

2. STEP1:準備!「札幌オフィス月次業績レポート」プレゼンテーションを用意しよう

まずは、GASから表を流し込むための練習用 Google スライドを作成しましょう!

作成手順

  1. Google ドライブ を開き、画面左上の「新規」>「Google スライド」をクリックして新しいプレゼンテーションを作成します。
  2. プレゼンテーションのタイトル(左上)を 「札幌オフィス月次業績レポート」 に変更します。
  3. 1枚目のスライドのレイアウトを「空白」にしておきます(上部メニュー「スライド」>「レイアウトを適用」>「空白」)。
  4. プレゼンテーションID を取得します。
    • URLバーの https://docs.google.com/presentation/d/【ここの英数字】/edit の部分をコピーしておきます(第61回で学んだ手順ですね!)。

3. STEP2:【実践】スライド内に表を自動作成してデータを入力してみよう!

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

今回は、スライド内に 4行3列 の「プロジェクト別売上・コスト推移表」を自動生成し、データをセットしてみます。

1. コードを入力する

プレゼンテーションのメニューバー「拡張機能」>「Apps Script」を開き、エディタ画面に以下のコードを貼り付けます(YOUR_PRESENTATION_ID はご自身のスライドIDに書き換えてください)。

function createProjectTable() {
  // ① プレゼンテーションと1枚目のスライドを取得する(第61回参照)
  var presentation = SlidesApp.openById("YOUR_PRESENTATION_ID");
  var slide = presentation.getSlides()[0];

  // ② 表の配置位置とサイズを設定(ポイント単位)
  var numRows = 4;   // 4行
  var numCols = 3;   // 3列
  var left = 50;     // 左から50pt
  var top = 100;     // 上から100pt
  var width = 620;   // 横幅620pt
  var height = 180;  // 高さ180pt

  // ③ スライドに表(Table)を挿入する
  var table = slide.insertTable(numRows, numCols, left, top, width, height);

  // ④ 表に入れるデータを用意(2次元配列)
  var tableData = [
    ["プロジェクト名", "売上(万円)", "コスト(万円)"],
    ["札幌スープカレーWeb広告", "1,200", "450"],
    ["新千歳空港店舗POS改修", "2,500", "1,100"],
    ["大通公園イベントアプリ開発", "850", "300"]
  ];

  // ⑤ ループ処理で表のセル(TableCell)にデータを順番に入力する
  for (var r = 0; r < tableData.length; r++) {
    for (var c = 0; c < tableData[r].length; c++) {
      // 指定した行(r)・列(c)のセルを取得してテキストをセット
      var cell = table.getCell(r, c);
      cell.getText().setText(tableData[r][c]);
    }
  }

  Logger.log("スライドへの表挿入とデータの流し込みが完了しました!");
}

2. コードの解説

1行ずつ仕組みを紐解いてみましょう。

  • var table = slide.insertTable(numRows, numCols, left, top, width, height);
    指定した位置と大きさで、4行3列の空の表(Table オブジェクト)を作成して変数 table に入れます。
  • var cell = table.getCell(r, c);
    Table.getCell(rowIndex, columnIndex) を使うことで、表の中の特定のマス目(TableCell)を掴みます。行番号・列番号は 0 から始まる(0-indexed) 点に注意しましょう(例:1行目・1列目は getCell(0, 0))。
  • cell.getText().setText(tableData[r][c]);
    掴んだセルから getText() でテキスト範囲を取り出し、setText() で文字列を入力します。

3. 実行結果の確認

コードを保存して「実行」ボタンをクリックし、Google スライドの画面を確認してみましょう!

スライドの指定した位置に 「札幌スープカレーWeb広告」 などのプロジェクト別実績データが入った綺麗な表が一瞬で挿入されているはずです!

4. STEP3:デザインを格上げ!ヘッダー行の着色と文字の装飾

表が挿入できたら、見栄えをさらに整えて「プレゼン資料としてそのまま使えるクオリティ」に仕上げましょう。

ヘッダー行(1行目)の背景色をネイビー(濃い青)にし、文字を白色&太字に装飾してみます。

装飾を追加したコード

function createStyledProjectTable() {
  var presentation = SlidesApp.openById("YOUR_PRESENTATION_ID");
  var slide = presentation.getSlides()[0];

  // 表の挿入(4行3列)
  var table = slide.insertTable(4, 3, 50, 100, 620, 180);

  var tableData = [
    ["プロジェクト名", "売上(万円)", "コスト(万円)"],
    ["札幌スープカレーWeb広告", "1,200", "450"],
    ["新千歳空港店舗POS改修", "2,500", "1,100"],
    ["大通公園イベントアプリ開発", "850", "300"]
  ];

  // データ入力 + 装飾処理
  for (var r = 0; r < tableData.length; r++) {
    for (var c = 0; c < tableData[r].length; c++) {
      var cell = table.getCell(r, c);
      var textRange = cell.getText();
      
      // テキストを入力
      textRange.setText(tableData[r][c]);

      // 1行目(ヘッダー行)の装飾
      if (r === 0) {
        // セルの背景色を「濃い青色」にする
        cell.getFill().setSolidFill("#003366");
        
        // 文字のスタイルを取得して装飾(白色 + 太字)
        var textStyle = textRange.getTextStyle();
        textStyle.setForegroundColor("#FFFFFF");
        textStyle.setBold(true);
        textStyle.setFontSize(14);
      } else {
        // 2行目以降(データ行)のフォントサイズ指定
        textRange.getTextStyle().setFontSize(12);
      }
    }
  }

  Logger.log("デザイン装飾付きの表が完成しました!");
}

追加したポイント

  1. cell.getFill().setSolidFill("#003366")
    セルの背景色をカラーコード指定(HEX)でベタ塗り設定します。
  2. textStyle.setForegroundColor("#FFFFFF")
    文字の色を白色に変更して、背景色とのコントラストを高めて読みやすくします。
  3. textStyle.setBold(true)
    ヘッダー文字を太字(ボールド)にして強調します。

これで、手動で作ったかのようなクオリティの高い業績表が自動生成されました!

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

Slide.insertTable() や表の操作を行う際、初心者が直面しやすい落とし穴と解決策をまとめました。

トラップ1:getCell(r, c) のインデックス指定は「0始まり」!

スプレッドシートの操作(getRange(1, 1) など)は「1始まり」が多いですが、スライドの Table.getCell(rowIndex, columnIndex) は 0 始まり(0-indexed) です。

  • ✕ 1行目・1列目:table.getCell(1, 1) ➡ 2行目・2列目のセルが取得されてしまう!
  • ◯ 1行目・1列目:table.getCell(0, 0)

トラップ2:IndexOutOfBounds エラーでプログラムが止まる

table.getCell(4, 3) のように、作成した行数・列数を超えるインデックスを指定すると、以下のエラーが発生します。

Exception: Index out of bounds: Row 4, Column 3

4行の表を作成した場合、有効な行インデックスは 0, 1, 2, 3(計4個)です。指定する数値を間違えないように注意しましょう。

トラップ3:insertTable() を実行しただけでは表の中身は空っぽ

insertTable() はあくまで「表の枠組み(コンテナ)」を作る命令です。

データを入力するには、今回のように table.getCell(r, c).getText().setText("文字") というステップを踏む必要があります。

トラップ4:スライド上の他の要素と被ってしまう

位置座標(left, top)を適当に指定すると、すでに配置されているタイトルテキストボックスや図形と重なってしまうことがあります。

第64回や第66回で学んだテキストボックスや図形の配置座標と重ならないよう、top の値(例:タイトルが top: 30 なら表は top: 100 など)を計算して調整しましょう。

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

今回は、Googleスライド内に自動で表を作成してデータを挿入する Slide.insertTable() について解説しました。

今日の重要ポイント

  • slide.insertTable(行数, 列数, left, top, width, height) で指定位置に表を作成できる
  • セルを取得するには table.getCell(rowIndex, columnIndex) を使い、インデックスは 0 始まり
  • cell.getFill().setSolidFill("#HEX") でセルの背景色を着色して見栄えを調整できる
  • cell.getText().setText() でマス目ごとにデータをセットする

スプレッドシートや外部データから受け取った数値をこの Slide.insertTable() と組み合わせれば、毎月の月次レポートの表作成が完全に一瞬で完了するようになります!

次回(第69回)は、Slide.insertSheetsChart() に挑戦します!

スプレッドシートで作った綺麗なグラフを、ボタン一つでスライドへ最新状態で埋め込む高度な自動化テクニックを学んでいきましょう。お楽しみに!