【GAS入門#66】スライドに文字枠を自由自在に配置!Slide.insertTextBox()の使い方と実践テクニック

「Googleスライドで作成するレポートに、プログラムから自動で説明文や注釈を追加したい」

「毎月発行する資料の決まった位置に、今月の総括コメントを自動挿入したい」

手動でプレゼンテーションを作成するとき、文章を書き込むために必ず配置するのが「テキストボックス」です。GAS(Google Apps Script)を使えば、このテキストボックスの作成から文字の入力、配置場所の指定までをすべて自動化できます。

前回([第64回] / [第65回])では、スライド上に四角形や丸などの図形を描画し、背景色や枠線を装飾する方法を学びました。今回は、スライド操作の中でも特に使用頻度が高いテキストボックスを自動配置するメソッド Slide.insertTextBox() を徹底解説します!

札幌オフィスの「月次業績レポート」を題材に、スライドの狙った位置へ「今月のトピックス・総括」用テキストボックスを配置するコードを書きながら、基本文法から座標指定のコツ、初心者がハマりやすい落とし穴まで分かりやすく解き明かしていきましょう。

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

Slide.insertTextBox() は、指定したスライド(Slide オブジェクト)の上に、新しいテキストボックス(文字入力用の枠)を作成して配置する命令(メソッド)です。

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

本連載でおなじみの「家・部屋・家具」のアナロジーを、Googleスライド操作編(フェーズ7)の構造に当てはめて復習してみましょう。

  • 【家】= プレゼンテーションファイル全体(Presentation)
    [第61回] で学んだ SlidesApp.openById() などで取得するファイルそのものです。
  • 【部屋】= 個別のスライドページ(Slide)
    [第63回] で複製したり選択したりした、1枚1枚のスライドキャンバスです。
  • 【家具・掲示物】= テキストボックスや図形・画像(PageElement / Shape)
    ★今回の主役!スライド上に配置されるテキストボックスは、部屋の壁に設置する「メッセージ掲示板」のような存在です。

Slide.insertTextBox() は、「指定した部屋(スライド)の壁に、新しいメッセージ掲示板(テキストボックス)を取り付ける」 という操作にあたります。

2. Slide.insertTextBox() の2つの書き方(構文)

insertTextBox() には、用途に合わせて使い分けられる2通りの構文(書き方)が用意されています。

パターン①:テキストのみを指定する(シンプル指定)

var textBox = slide.insertTextBox("書き込みたい文章");
  • 説明:表示させたい文字列だけを渡す最小限の書き方です。
  • 動作:スライドの中央付近に、文字数に合わせたデフォルトサイズで自動配置されます。
  • 使いどころ:位置にこだわりがなく、とりあえず画面上に文字を出力したい場合に便利です。

パターン②:テキスト・位置・サイズをすべてミリ単位で指定する(位置固定指定・おすすめ!)

var textBox = slide.insertTextBox("書き込みたい文章", left, top, width, height);
  • 説明:文章に加えて、スライド上の配置場所(left, top)とボックスの大きさ(width, height)を数値で厳密に指定します。
  • 使いどころ:レポートのテンプレートなど、決まったレイアウトの位置へきれいに収めたい実務開発で必須となる書き方です。

3. STEP1:準備!「札幌オフィス月次業績レポート」スライドを用意しよう

まずは、GASから操作するための練習用Googleスライドを作成しましょう。

作成手順

  1. Googleドライブ を開き、左上の「+ 新規」>「Googleスライド」をクリックして新しいプレゼンテーションを作成します。
  2. ファイル名を 「札幌オフィス月次業績レポート」 に変更します。
  3. スライド1枚目のタイトルに 「札幌オフィス 今月の業績報告」 と入力しておきます。
  4. スライドID(Presentation ID) を取得します。ブラウザのWebアドレスバーに表示されているURLから、以下の赤字部分の英数字(ID)をコピーしてください。https://docs.google.com/presentation/d/1ABC123xyz_ExampleID_xxxxxxxxxxxx/edit

これで準備は完了です!

4. STEP2:【実践】スライド内に「今月のトピックス」用テキストボックスを配置しよう

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

スプレッドシートや独立型のGASエディタから、先ほど作成したスライドを開き、指定の位置に「今月のトピックス・総括」のテキストボックスを追加してみます。

1. コードを入力する

GASのエディタを開き、既存のコードを消去して以下のスクリプトを貼り付けます。

【ここにあなたのスライドIDを貼り付け】 の部分には、STEP1で取得したIDを入力してください。

function addTopicsTextBox() {
  // ① [第61回] の知識:スライドファイルをID指定で開く(家を取得)
  var presentationId = "【ここにあなたのスライドIDを貼り付け】";
  var presentation = SlidesApp.openById(presentationId);
  
  // ② 1枚目のスライドを取得する(部屋を取得)
  var slide = presentation.getSlides()[0];
  
  // ③ 挿入したい本文テキストを準備
  var topicsText = "【今月のトピックス(札幌オフィス)】\n" +
                   "・新設された札幌AI開発チームの稼働率が120%を達成しました。\n" +
                   "・地元企業向けセミナーの満足度が98%を記録し、新規案件につながっています。";
                   
  // ④ 位置とサイズを指定してテキストボックスを挿入(家具を配置)
  // 引数:(テキスト, X座標[Left], Y座標[Top], 横幅[Width], 高さ[Height])
  var left = 50;     // 左端からの距離(ポイント)
  var top = 180;     // 上端からの距離(ポイント)
  var width = 600;   // テキストボックスの幅(ポイント)
  var height = 120;  // テキストボックスの高さ(ポイント)
  
  var textBox = slide.insertTextBox(topicsText, left, top, width, height);
  
  // ⑤ 実行ログで確認
  Logger.log("テキストボックスの配置が完了しました!要素タイプ: " + textBox.getPageElementType());
}

2. 保存して実行する

  1. エディタ上部の 「保存(フロッピーディスクのアイコン)」 をクリックします。
  2. 実行する関数が addTopicsTextBox になっていることを確認し、「実行」 ボタンをクリックします。
  3. 初回実行時はアクセスの承認を求められるため、画面の指示に従って許可([第2回] 参照)を行ってください。

3. 実行結果の確認

作成したGoogleスライドの画面を開いて確認してみましょう!

タイトル(札幌オフィス 今月の業績報告)の下部(top: 180 付近)に、「【今月のトピックス(札幌オフィス)】…」 と記載された横幅の広いテキストボックスが綺麗に配置されていれば大成功です!

5. STEP3:徹底解説!座標(Left/Top)とサイズ(Width/Height)の指定ルール

プログラミングでデザインやレイアウトを扱う際、最も重要になるのが「座標軸」と「単位」の考え方です。

1. スライド上の座標軸(原点は「左上」)

Googleスライドの画面上における位置は、スライドの「左上の角」を原点 $(X=0, Y=0)$ とした平面で計算されます。

 (0,0) 左上原点 ───────────────────────────────┐
│ │
│ ← left → ┌──────────────┐ │
│ ▲ │ テキスト │ │
│ top │ ボックス │ height │
│ ▼ └──────────────┘ │
│ ← width → │
│ │
└───────────────────────────────────────────┘
  • left (X座標):スライドの左端から、テキストボックスの左端までの距離
  • top (Y座標):スライドの上端から、テキストボックスの上端までの距離
  • width (横幅):テキストボックス自体の水平方向の長さ
  • height (高さ):テキストボックス自体の垂直方向の長さ

2. 距離の単位は「ポイント(pt)」

GASの標準的なスライド操作において、位置やサイズを指定する数値の単位は ポイント(pt) です。

  • $1 \text{ インチ} = 72 \text{ pt}$
  • スライドの標準サイズ(16:9 ワイドスクリーン)は、横幅が 720 pt、高さが 405 pt です。

位置指定で迷った場合は、以下の目安数値を参考にレイアウトを組み立ててみましょう。

画面の位置推奨 left (pt)推奨 top (pt)
画面の左側(半分に配置)30 〜 50100 〜 150
画面の右側(半分に配置)500 〜 520100 〜 150
画面の下部(フッター・総括)50 〜 100400 〜 450

6. 実務で役立つ!insertTextBox() の戻り値と活用法

slide.insertTextBox() を実行すると、戻り値として Shape オブジェクト(図形オブジェクト)が返されます。

「えっ?テキストボックスを作ったのに Shape(図形)が返ってくるの?」と不思議に思うかもしれません。実は、Googleスライドの内部構造において、テキストボックスは「背景や枠線が透明な四角形の図形(Shape)」として管理されているからです。

そのため、作成したテキストボックス(Shape)に対して、過去記事で学んだ図形装飾のメソッドをそのまま適用することができます。

// テキストボックスを作成
var textBox = slide.insertTextBox("重要なメモ", 50, 100, 300, 80);

// [第65回] で学んだ知識:背景色をパステルイエローにする!
textBox.getFill().setSolidFill("#fff2cc");

// [第65回] で学んだ知識:枠線をグレーに設定する!
textBox.getBorder().getLineFill().setSolidFill("#cccccc");

このように、insertTextBox() で作った枠に背景色や枠線を設けることで、一瞬で「注釈カード」や「ハイライト枠」へと変身させることができます。

7. 初心者が絶対にミスする!5大トラップと解決策

Slide.insertTextBox() を使う際、プログラミング初心者やGAS学習者が非常によく直面するエラーやトラブルを5つ厳選しました。あらかじめ対策を知っておきましょう!

トラップ1:Presentation(家)に対して呼び出して TypeError になる

// ✕ エラーになる書き方(Presentationオブジェクトに対して直接呼んでいる)
var presentation = SlidesApp.openById("ID");
presentation.insertTextBox("メッセージ"); 
// エラー:TypeError: presentation.insertTextBox is not a function

【原因と解決策】

insertTextBox() は、ファイル全体(Presentation)の命令ではなく、個別のスライド(Slide)が持っている命令 です。必ず presentation.getSlides()[0] などでスライド(部屋)を取り出してから呼び出しましょう。

トラップ2:引数の順番を勘違いして思わぬ場所に飛んでしまう

// ✕ 間違えた順番の例(topとleftを逆にしてしまうなど)
slide.insertTextBox("テキスト", top, left, height, width);

【原因と解決策】

引数の順番は厳格に決まっています。

(テキスト, left, top, width, height) の順番(テキスト・左・上・幅・高さ)を丸暗記するか、単語の頭文字をとって「テレ東はウハウハ」と覚えましょう(笑)。

トラップ3:指定したサイズが小さすぎて文字が溢れる・自動改行される

文字数が非常に多いにもかかわらず width や height を小さく指定しすぎると、テキストが枠からはみ出したり、不自然な場所で改行されて見映えが悪くなります。

【解決策】

長文を入力する場合は、width を広め(例: 500〜700pt)に設定しておくか、あらかじめ改行文字 \n を適正な位置に挿入しておきましょう。

トラップ4:既存の要素と重なって画面が見づらくなる

自動生成を繰り返していると、毎回同じ座標(left: 50, top: 180 など)に新しいテキストボックスが追加され、過去に作成した要素と何重にも重なってしまうことがあります。

【解決策】

テスト実行する際は、手動で不要な要素を消去するか、プログラムの冒頭でスライド上の古い要素をクリアする処理(今後の回で解説)を挟むと快適に開発できます。

トラップ5:insertTextBox() だけではフォントサイズや色が変えられない?

「テキストボックスは作れたけれど、文字をもっと大きくしたい!『120%達成』の部分だけ赤色で強調したい!」という場面があります。

実は、insertTextBox() の引数で指定できるのは「プレーンな文字列」のみです。文字の装飾やフォント変更を行うには、作成したテキストボックスから TextRange オブジェクト を取り出して操作する必要があります。

今回のまとめと次回予告

今回は、Googleスライド内に「今月のトピックス」用のテキストボックスを自在に配置する Slide.insertTextBox() を解説しました。

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

  1. Slide.insertTextBox() はスライド上に新しい文字枠を作成する命令
  2. 位置指定には (テキスト, left, top, width, height) の5つの引数を渡す
  3. 座標の原点はスライドの「左上」、距離の単位は「ポイント(pt)」
  4. 戻り値は Shape オブジェクトなので、背景色や枠線の装飾も可能

これでスライド上の狙った場所に、プログラムから文字を入力する枠を用意できるようになりました!

さて、枠が配置できたら、次は 「中の文字をもっと大きく装飾したり、特定のキーワードだけを太字やカラーで劇的に強調したい!」 と思うはずです。

次回(第67回)は、TextRange.setText() / setFontSize() を解説します!

今回挿入したテキストボックス内の文章を自由自在に書き換え、「達成率120%」といった重要ワードの文字サイズをドカンと拡大して強調する実践テクニックを学んでいきましょう。お楽しみに!