【GAS入門#64】Googleスライドに図形を自動描画!Slide.insertShape()でトピックスカードを作成しよう

前回(第63回)は、プレゼンのページを自由自在に増殖させる Slide.duplicate() について解説しました。テンプレートスライドを複製して、「開発部」「営業部」といった部署ごとのページを自動生成するテクニックを学びましたね。

スライドのページ数が揃ったら、次にやりたくなるのが「スライドの中身(デザイン要素)を自動で作成すること」です! 特に月次業績レポートなどで、「今月のトピックス」や「売上ハイライト」を目立たせるために、四角いカード状の図形(トピックスカード)を配置するデザインはビジネスプレゼンの定番ですよね。

手動で図形を挿入して、サイズや位置をマウスで微調整するのは時間がかかりますし、毎月同じ作業を繰り返すのは大変です。

そこで第64回となる今回は、指定したスライド上に好きな図形(四角形や丸角長方形など)をプログラムから自動で描画できる超重要メソッド Slide.insertShape() を徹底解説します!

フェーズ7でテーマとしている「札幌オフィス月次業績レポート」を題材に、図形を好きな位置・サイズでピタッと描画するコツから、初心者がつまずきやすい「座標指定(ポイント単位)」の考え方、落とし穴まで、どこよりも分かりやすく丁寧に紐解いていきます!

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

Slide.insertShape() は、指定したスライド(Slideオブジェクト)の上に、新しい図形(Shapeオブジェクト)を自動で生成・配置する命令(メソッド)です。

「家・部屋・家具」の例えで位置づけをおさらい!

本連載でおなじみの「家・部屋・家具」の例えで、Googleスライド操作の階層構造を整理してみましょう。

  • 【家】= プレゼンテーション全体(SlidesApp.openById() で取得)
  • 【部屋】= 個別のスライドページ(Presentation.getSlides()[0] などで取得)
  • 【家具】= スライド上の図形・テキストボックス・画像など(★今回の主役!)

[第4回]や[第10回]のスプレッドシート編で「セル」を家具に例えたように、スライド操作においては「スライドの上に配置する図形やテキスト枠」が家具にあたります。

Slide.insertShape() は、まさにこの「部屋(スライド)」の中に、「新しい四角い棚やカード(図形)」をミリ単位の正確さでポンッと運び込んで設置する操作にあたります。

コードの基本構文

Slide.insertShape() を使うときは、「どんな形の図形を」「どこに(X軸・Y軸)」「どれくらいの大きさで(横幅・高さ)」置くのかを5つの指定値(引数)で指示します。

// スライド上に四角形の図形を挿入する基本構文
var shape = slide.insertShape(図形の種類, 左からの距離, 上からの距離, 横幅, 高さ);

2. 5つの引数を完全マスターしよう!

insertShape() に渡す5つの引数(ひきすう)について、1つずつ詳しく確認していきましょう。

順番引数名意味・説明設定例
第1引数shapeType図形の種類(定数で指定)SlidesApp.ShapeType.RECTANGLE
第2引数leftスライド左端からの距離(X座標)50(単位:pt)
第3引数topスライド上端からの距離(Y座標)100(単位:pt)
第4引数width図形の横幅250(単位:pt)
第5引数height図形の高さ150(単位:pt)

① 第1引数:図形の種類(ShapeType)

どんな図形を描くかは、SlidesApp.ShapeType という専用のキーワードを使って指定します。代表的な種類は以下の通りです。

  • SlidesApp.ShapeType.RECTANGLE :普通の長方形(四角形)
  • SlidesApp.ShapeType.ROUNDED_RECTANGLE :角が丸い長方形(トピックスカードに最適!)
  • SlidesApp.ShapeType.ELLIPSE :円・楕円
  • SlidesApp.ShapeType.TEXT_BOX :テキストボックス(※テキスト専用図形)

ビジネス資料のトピックスカードには、柔らかい印象を与える ROUNDED_RECTANGLE(角丸長方形) や標準的な RECTANGLE(長方形) がよく使われます。

② 第2〜第5引数:位置とサイズを指定する「pt(ポイント)」という単位

位置(left, top)とサイズ(width, height)は、すべて 「pt(ポイント)」 という数値で指定します。

  • 1 pt ≒ 約0.35 mm(72 pt = 1 インチ)
  • 標準的なワイド画面スライド(16:9)のサイズ
    • 横幅: 960 pt
    • 高さ: 540 pt

スライドの左上隅(角)が「X=0, Y=0」の原点となります。

  • left: 50 ➡ スライドの左端から右へ 50pt 進んだ位置
  • top: 100 ➡ スライドの上端から下へ 100pt 進んだ位置

この数値の感覚を掴んでおくと、図形をレイアウトするときに狙った場所へピタッと配置できるようになります!

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

それでは、実際にGASから図形を描くための練習用Googleスライドを用意しましょう!

作成手順

  1. Googleドライブを開き、新規のGoogleスライドを1冊作成します。
  2. ファイル名を 「札幌オフィス月次業績レポート」 に変更します。
  3. 1枚目のスライドを「白紙」レイアウトにするか、最初からあるタイトル枠を全選択して削除し、真っ白な状態にしておきます。
  4. ブラウザのアドレスバー(URL)から、スライドIDをコピーして手元にメモしておきます。

URLの例: https://docs.google.com/presentation/d/ 1a2b3c4d5e6f7g8h9i0j_EXAMPLE_ID /edit
※ /d/ と /edit の間にある長英数字がスライドIDです。[第61回]で学んだ手順ですね!

4. STEP2:【実践】スライドに「トピックスカード用図形」を描画してみよう!

準備ができたら、GASのエディタを開いてプログラムを書いていきましょう。 今回は、札幌オフィスの今月の実績ハイライト(「スープカレーコラボ企画大盛況」「新千歳空港出張所オープン」など)を記載するための角丸長方形カードを1つ作成してみます。

1. コードを入力する

[第1回]で学んだコンテナバインドスクリプト、またはスタンドアロンスクリプトのエディタを開き、以下のコードを貼り付けます。 (YOUR_SLIDE_ID_HERE の部分は、先ほどメモしたご自身のスライドIDに書き換えてください。)

function createTopicsCard() {
  // ① 「家(プレゼンテーション)」をIDで開く
  var slideId = "YOUR_SLIDE_ID_HERE";
  var presentation = SlidesApp.openById(slideId);
  
  // ② 「部屋(1枚目のスライド)」を取得する
  var slide = presentation.getSlides()[0];
  
  // ③ カードの位置とサイズを定義する(単位: pt)
  var left = 50;     // 左端から50pt
  var top = 100;     // 上端から100pt
  var width = 260;   // 横幅260pt
  var height = 320;  // 高さ320pt
  
  // ④ スライド上に角丸長方形の図形(トピックスカード)を描画!
  var cardShape = slide.insertShape(
    SlidesApp.ShapeType.ROUNDED_RECTANGLE,
    left,
    top,
    width,
    height
  );
  
  // ⑤ 完了ログを出力
  Logger.log("札幌オフィスのトピックスカード用図形を正常に描画しました!");
}

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

  • var presentation = SlidesApp.openById(slideId);
    [第61回]で学んだ基本命令です。指定したIDのプレゼンテーション(家)を取得します。
  • var slide = presentation.getSlides()[0];
    プレゼンテーション内の1枚目のスライド(部屋)を取得しています。
  • slide.insertShape(SlidesApp.ShapeType.ROUNDED_RECTANGLE, left, top, width, height);
    今回の主役です!1枚目のスライドに対して、角が丸い長方形を (X=50, Y=100) の位置に 幅260pt × 高さ320pt の大きさで挿入しています。

3. 保存して実行する

  1. エディタ上部の 「保存アイコン(フロッピー)」 をクリックします。
  2. 関数が createTopicsCard になっていることを確認し、「実行」 をクリックします。
  3. 初回実行時はGoogleの承認画面が出ますので、アクセスを許可してください。
  4. Googleスライドの画面を開いて確認してみましょう!

【実行結果の確認】 スライドの左側に、グレー(またはデフォルト色)の綺麗な角丸長方形のカード図形がポンと配置されていれば大成功です!

5. STEP3:応用!計算式を使って「3連トピックスカード」を美しく横並び描画しよう

1枚のカードを描画できたら、次は実務でよく使われる「3つのトピックスカードを横一列に均等配置する」高度なテクニックに挑戦してみましょう!

手動で3つの図形を同じ大きさで並べようとすると、間隔(マージン)の計算や位置調整が面倒ですよね。しかし、GASの for ループと簡単な算数を使えば、一瞬で完璧に揃った3連カードを自動描画できます!

3連カード自動配置コード

function createTripleTopicsCards() {
  var slideId = "YOUR_SLIDE_ID_HERE";
  var presentation = SlidesApp.openById(slideId);
  var slide = presentation.getSlides()[0];
  
  // 配置の計算用パラメータ設定
  var startLeft = 50;   // 最初のカードの左端位置
  var top = 120;        // 全カード共通のY座標
  var cardWidth = 260;  // 1枚あたりの横幅
  var cardHeight = 300; // 1枚あたりの高さ
  var gap = 40;         // カード同士の「すき間(間隔)」
  
  // forループを使って3枚のカードを順番に描画!
  for (var i = 0; i < 3; i++) {
    // i番目のカードのX座標を計算(★ここがポイント!)
    // 1枚目(i=0): 50 + 0 = 50
    // 2枚目(i=1): 50 + (260 + 40) * 1 = 350
    // 3枚目(i=2): 50 + (260 + 40) * 2 = 650
    var currentLeft = startLeft + (cardWidth + gap) * i;
    
    // 図形を描画
    var card = slide.insertShape(
      SlidesApp.ShapeType.ROUNDED_RECTANGLE,
      currentLeft,
      top,
      cardWidth,
      cardHeight
    );
    
    Logger.log((i + 1) + "枚目のトピックスカードを描画しました(X座標: " + currentLeft + "pt)");
  }
}

実行結果

実行ボタンを押してスライドを見てみてください。 スライド上に、横幅260ptのカードが「40ptのすき間」を綺麗に保ちながら3つ横並びでピシッと描画されたはずです!

このように、currentLeft = startLeft + (cardWidth + gap) * i というシンプルな計算式を変数に組み込むだけで、デザインの崩れない完璧なレイアウトが自動化できます。

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

Slide.insertShape() を使う際、初心者が直面しやすいエラーやトラブルを4つ厳選しました。あらかじめ知っておくことで、無用なトラブルを防ぐことができますよ!

トラップ1:引数の順番を間違えて図形が変形・画面外へ消える

初心者事故率No.1のミスです。insertShape は引数が5つもあるため、順番を入れ替えて書いてしまうことがあります。

// ✕ NG:leftとtop、widthとheightの順番がごちゃごちゃ
slide.insertShape(SlidesApp.ShapeType.ROUNDED_RECTANGLE, top, left, height, width);

// ◯ OK:正しい順番(種類 ➡ 左 ➡ 上 ➡ 幅 ➡ 高さ)
slide.insertShape(SlidesApp.ShapeType.ROUNDED_RECTANGLE, left, top, width, height);

【合言葉で覚える解決策】 「種類・左・上・幅・高さ(しゅり・ひだり・うえ・はば・たかさ)」 と呪文のように唱えて順番をチェックしましょう!

トラップ2:ShapeType のスペルミス(タイポ)でエラーになる

SlidesApp.ShapeType.ROUNDED_RECTANGLE などの定数は、大文字・小文字・アンダースコア(_)が厳密に決まっています。

  • ✕ SlidesApp.shapetype.rectangle(小文字になっている)
  • ✕ SlidesApp.ShapeType.ROUND_RECTANGLE(ED が抜けている)

【解決策】 手入力せず、エディタで SlidesApp.ShapeType. まで入力したときに出てくる 自動補完(予測変換候補) から選択して入力するのが最も確実です!

トラップ3:座標(left / top)が大きすぎて画面外に吹き飛ぶ

スライドのサイズ感覚(横960pt × 縦540pt)を忘れて、left = 1200 や top = 800 などの大きな数値を渡してしまうと、図形がスライドの枠外(キャンバスの外側)に描画されて「見えなくなる」現象が発生します。

【解決策】

  • 横位置(left)は 0 〜 700 pt 程度
  • 縦位置(top)は 0 〜 400 pt 程度

上記の範囲内に収まるよう計算して数値をセットしましょう。

トラップ4:「図形の中に文字を入力したいのに書き方が分からない!」

insertShape() で図形を描画しても、作成された時点ではただの「無地の図形」です。

「このトピックスカードの中に『札幌オフィス今月の売上達成率120%』という文字を入れたい!」と思われるはずです。 図形の中にテキストを入力したり、文字サイズを大きく装飾したりするには、今後詳しく学ぶ Shape.getText() や TextRange.setText() と組み合わせて操作します!

今回作成した cardShape 変数を取っておくことで、次のステップで自由自在に文字を流し込めるようになりますので、楽しみにしていてくださいね。

7. まとめ&次回予告

今回は、Googleスライド上に自動で図形を描画する Slide.insertShape() について解説しました。

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

  1. Slide.insertShape() はスライド上に新しい図形(家具)を自動配置する命令
  2. 引数は「種類・左・上・幅・高さ」の順番で5つ渡す
  3. 図形の種類は SlidesApp.ShapeType.ROUNDED_RECTANGLE などで指定する
  4. 位置とサイズは「pt(ポイント)」単位で計算する(16:9スライドは横960pt×縦540pt)
  5. for ループと計算式を組み合わせれば、美しい多連カード配置も一瞬で完成する

これで、プログラムの力でプレゼン資料の「骨組み(カードや枠組み)」を自動生成できるようになりました!

しかし、デフォルトで挿入された図形は、味気ないグレーや薄い青色の単色であることが多いですよね。 実務のプレゼンでは、「業績達成(目標クリア)なら明るい緑色のカード」「未達成なら注意を示す赤色のカード」 というように、成果に応じた色分けや枠線の装飾を施したい場面が多々あります。

そこで次回(第65回)は、今回作成した図形の背景色や枠線を自由自在にドレスアップする Shape.getFill() / getBorder() を解説します! 条件に応じたカードのカラーリング制御を学び、さらにプロっぽいプレゼン資料へと仕上げていきましょう。お楽しみに!