【GAS入門#69】スプレッドシートのグラフをスライドへ自動埋め込み!Slide.insertSheetsChart()の完全攻略ガイド

前回の第68回では、Slide.insertTable() を使ってGoogleスライド内に「プロジェクト別売上・コスト推移表」を自動生成する方法を学びましたね! 表形式で数値を整然と見せるのも素晴らしいですが、役員会議や月次報告会などのプレゼンテーションでは「視覚的にひと目で伝わるグラフ」が欠かせません。

ですが、毎月の報告資料を作るときに、こんな苦労をしていませんか?

  • 「スプレッドシートで作った売上グラフを、毎月手動でスライドにコピペするのが面倒…」
  • 「手動で貼ると、毎月グラフの位置や大きさが微妙にズレて見栄えが悪くなる…」
  • 「元データの数値が変わったのに、スライド側のグラフを更新し忘れて古い数値のまま発表してしまった…」

今回学習する Slide.insertSheetsChart() を使えば、Googleスプレッドシート上で作成したグラフ(売上推移や達成率など)を、ボタン1つで指定したスライドの狙った位置へ一瞬で自動埋め込みできるようになります!

札幌オフィスの月次報告レポートを自動化する実践的なコードを書きながら、基本操作からサイズ・位置のミリ単位調整、さらには初心者が必ずハマる注意点まで、どこよりも分かりやすく徹底解説していきます!

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

Slide.insertSheetsChart() は、Googleスプレッドシート内に存在するグラフ(EmbeddedChart オブジェクト)を取得し、Googleスライド上の指定したページ(Slide オブジェクト)へ埋め込んで配置するための命令(メソッド)です。

基本的なコードの構文(2つの書き方)

insertSheetsChart() には、大きく分けて2つの書き方(オーバーロード)があります。

パターン①:シンプルにデフォルト位置(画面左上付近)へ挿入する

var sheetsChart = slide.insertSheetsChart(sourceChart);
  • sourceChart:スプレッドシートから取得した埋め込みグラフオブジェクト(EmbeddedChart)
  • 特徴:位置やサイズを指定せず、自動的に標準サイズでスライドに配置します。

パターン②:位置(座標)とサイズ(幅・高さ)を細かく指定して挿入する【実務で大活躍!】

var sheetsChart = slide.insertSheetsChart(sourceChart, left, top, width, height);
  • left:スライドの左端からの位置(ポイント単位:pt)
  • top:スライドの上端からの位置(ポイント単位:pt)
  • width:グラフの横幅(ポイント単位:pt)
  • height:グラフの高さ(ポイント単位:pt)
  • 特徴:指定した場所・サイズでピッタリと綺麗に挿入できます。

2. 「家・部屋・家具」の例えで理解するスライドとグラフの関係

本連載でおなじみの「家・部屋・家具」の例えを使って、スプレッドシートとスライドを跨ぐ(連携する)今回の処理構造を整理してみましょう!

第2回〜第4回でスプレッドシートの構造を学び、第61回以降でスライドの操作を学んできましたね。今回の処理は2つの家(ファイル)を行き来するコラボレーション操作になります。

概念現実世界での例えスプレッドシート側の対象スライド側の対象
ファイル全体(家)本社ビル・支社ビルSpreadsheetApp.openById()SlidesApp.openById()
個別ページ(部屋)会議室や個室Spreadsheet.getSheetByName()Presentation.getSlides()[0]
要素・パーツ(家具)ポスターや掲示物Sheet.getCharts()[0](元グラフ)Slide.insertSheetsChart()(埋め込みグラフ)

スプレッドシートという「第1の家」からお気に入りの額縁グラフ(家具)を取り出し、スライドという「第2の家」の特定の部屋(スライドページ)の壁にピタッと飾る操作、それが Slide.insertSheetsChart() なのです!

3. STEP1:事前準備!スプレッドシートとプレゼンテーションを用意しよう

それでは、実際にGASを動かすための練習用ファイルを用意していきましょう!

今回は「札幌オフィス 月次売上レポート」を題材にします。

1. スプレッドシートの準備(グラフの作成)

  1. Googleドライブで新しいGoogleスプレッドシートを作成し、ファイル名を 「【札幌オフィス】月次売上データ」 にします。
  2. シート名を 「売上推移」 に変更します。
  3. 以下の表データを入力してください。
A列(月)B列(売上:万円)C列(目標:万円)
4月12001000
5月13501200
6月11001200
7月15001300
8月16801400
  1. A1:C6 の範囲をドラッグ選択し、上部メニューの 「挿入」 > 「グラフ」 をクリックします。
  2. 集合縦棒グラフまたは折れ線グラフがシート上に作成されたことを確認します。

💡 スプレッドシートのIDをメモしておこう!

ブラウザのアドレスバーに表示されているURLから、以下の赤字部分(ID)をコピーしてメモ帳などに控えておきます。

https://docs.google.com/spreadsheets/d/ 1A2B3C4D5E6F7G8H9I0J_EXAMPLE_SS_ID /edit

2. Googleスライドの準備

  1. Googleドライブで新しいGoogleスライドを作成し、ファイル名を 「札幌オフィス_月次業績報告プレゼン」 にします。
  2. 1枚目のスライドのタイトル欄に「札幌オフィス 月次売上トピックス」と入力しておきます。

💡 スライドのIDもメモしておこう!

URLからスライドのIDをコピーして控えておきます。

https://docs.google.com/presentation/d/ 9Z8Y7X6W5V4U3T2S1R0Q_EXAMPLE_SLIDE_ID /edit

これで準備は完璧です!

4. STEP2:【実践】スプレッドシートのグラフをスライドに自動埋め込みしてみよう!

準備ができたら、スプレッドシート(またはスライド)のコンテナバインドスクリプト、もしくはスタンドアロンスクリプトを開いてコードを書いていきましょう!

(今回はどちらからでも実行可能な openById 方式で記述します)

1. エディタを開いてコードを入力する

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

※ SS_ID と SLIDE_ID の部分は、先ほどメモしたご自身のIDに置き換えてくださいね!

function embedSapporoSalesChart() {
  // -----------------------------------------------------------------
  // 1. 【スプレッドシート側】元となるグラフ(EmbeddedChart)を取得する
  // -----------------------------------------------------------------
  // スプレッドシートのIDを指定して開く
  var ssId = "1A2B3C4D5E6F7G8H9I0J_EXAMPLE_SS_ID"; // ←ご自身のスプレッドシートIDに変更
  var ss = SpreadsheetApp.openById(ssId);
  
  // 「売上推移」シートを取得する
  var sheet = ss.getSheetByName("売上推移");
  
  // シート内に存在するすべてのグラフを取得する(配列で返ってくる)
  var charts = sheet.getCharts();
  
  // グラフが存在するか確認チェック
  if (charts.length === 0) {
    Logger.log("エラー: 指定したシートにグラフが見つかりませんでした。");
    return;
  }
  
  // 1つ目のグラフ(インデックス 0)をターゲットとして取得
  var sourceChart = charts[0];

  // -----------------------------------------------------------------
  // 2. 【スライド側】挿入先のスライドページを取得する
  // -----------------------------------------------------------------
  // プレゼンテーションのIDを指定して開く
  var presentationId = "9Z8Y7X6W5V4U3T2S1R0Q_EXAMPLE_SLIDE_ID"; // ←ご自身のスライドIDに変更
  var presentation = SlidesApp.openById(presentationId);
  
  // 1枚目のスライド(インデックス 0)を取得する
  var targetSlide = presentation.getSlides()[0];

  // -----------------------------------------------------------------
  // 3. 【本日のメイン】スライドにスプレッドシートのグラフを埋め込む!
  // -----------------------------------------------------------------
  var insertedChart = targetSlide.insertSheetsChart(sourceChart);

  // 実行結果をログに出力(第1回で学んだ Logger.log)
  Logger.log("札幌オフィスの月次売上グラフをスライドへ正常に埋め込みました!");
}

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

プログラミング初心者の方のために、重要ポイントを1行ずつ紐解いていきましょう!

  • var charts = sheet.getCharts();
    • スプレッドシートの Sheet オブジェクトが持っているメソッドです。シート内にあるすべての埋め込みグラフを配列(リスト)形式で取ってきます。
  • var sourceChart = charts[0];
    • 配列の1番目(プログラミングの世界では0から数えます!)に入っている EmbeddedChart オブジェクト(グラフ本体)を取り出しています。
  • var presentation = SlidesApp.openById(presentationId);
    • 第61回で学んだ SlidesApp.openById() ですね!プレゼンテーション全体を開きます。
  • var targetSlide = presentation.getSlides()[0];
    • プレゼンテーション内の全スライドから、1枚目のスライドページを選択しています。
  • targetSlide.insertSheetsChart(sourceChart);
    • 本日の主役メソッドです! 選択したスライド(targetSlide)に対して、スプレッドシートのグラフ(sourceChart)を自動的に貼り付けています。

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

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

【実行結果】

1枚目のスライドの中央付近に、スプレッドシートで作成した「札幌オフィスの月次売上グラフ」がドーンと埋め込まれていれば大成功です!

5. STEP3:【応用に挑戦】埋め込み位置やサイズ(座標・幅・高さ)をミリ単位で指定する!

デフォルト位置への挿入ができるようになったら、次は実務で最もよく使う「配置座標とサイズの直接指定」に挑戦してみましょう!

スライドの画面サイズは一般的に標準(16:9)の場合、横幅:720pt、高さ:405pt で構成されています。

例えば「スライドの左側にグラフを置き、右側に文章テキストボックスを配置したい」という場合、グラフの位置とサイズをあらかじめ計算して指定する必要があります。

座標・サイズ指定のコード例

function embedSapporoSalesChartWithPosition() {
  var ss = SpreadsheetApp.openById("1A2B3C4D5E6F7G8H9I0J_EXAMPLE_SS_ID");
  var sourceChart = ss.getSheetByName("売上推移").getCharts()[0];
  
  var presentation = SlidesApp.openById("9Z8Y7X6W5V4U3T2S1R0Q_EXAMPLE_SLIDE_ID");
  var targetSlide = presentation.getSlides()[0];

  // -----------------------------------------------------------------
  // 配置座標とサイズをポイント(pt)単位で定義する
  // -----------------------------------------------------------------
  var left = 40;     // 左端からの距離(40pt)
  var top = 100;     // 上端からの距離(100pt:タイトル下に配置)
  var width = 380;   // グラフの横幅(380pt)
  var height = 250;  // グラフの高さ(250pt)

  // 5つの引数を渡してグラフをジャストサイズで挿入!
  var positionedChart = targetSlide.insertSheetsChart(
    sourceChart, 
    left, 
    top, 
    width, 
    height
  );

  Logger.log("指定した座標・サイズでグラフを綺麗に配置しました!");
}

このコードを実行すると、スライドの左側に綺麗に収まる形でグラフが挿入されます。右側の空いたスペース(left: 440 付近)には、第66回で学んだ Slide.insertTextBox() を使ってトピックスの解説文章を入れると、完璧な見栄えの報告資料が完成しますね!

6. スプレッドシートとスライドの「グラフ連携(リンク)」の仕組みと更新方法

Slide.insertSheetsChart() を使って埋め込まれたグラフには、非常に強力な特徴があります。

それは、「元のスプレッドシートとリアルタイムにリンク(連携)している」 ということです!

リンク付きグラフ(Linked Sheets Chart)のメリット

スライド上に挿入されたグラフを選択すると、右上に小さな 「スプレッドシートのリンク」 アイコンが表示されます。

もし翌月になってスプレッドシート側の売上数値が更新されたり、グラフのデザイン(色やタイトル)を変更した場合でも、スライド側で「更新」ボタンを押すだけで、最新のグラフ画像に自動差し替えされます。

プログラム(GAS)からスライド上のグラフを最新状態に一括更新するには?

将来的に完全自動化を目指す場合、スライド上のグラフオブジェクト(SheetsChart)に対して .refresh() メソッドを実行することで、手動で更新ボタンを押さなくてもGASから最新の売上データに同期させることができます!

// スライド上の埋め込みグラフを一括更新するコード例
var sheetsCharts = targetSlide.getSheetsCharts();
for (var i = 0; i < sheetsCharts.length; i++) {
  sheetsCharts[i].refresh(); // スプレッドシートの最新データでグラフを更新!
}

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

Slide.insertSheetsChart() を使用する際、初心者が特によく遭遇するエラーやトラブルを5つ厳選してまとめました。ここで予習してハマりやすい落とし穴を回避しましょう!

トラップ1:sheet.getCharts() のあとに [0] をつけ忘れてエラーになる

✕ 間違いコード

var sourceChart = sheet.getCharts(); // 配列のまま渡してしまう!
targetSlide.insertSheetsChart(sourceChart);

🚨 エラーメッセージ

Exception: The parameters (JavaScript Array) don't match the method signature for Slide.insertSheetsChart.

💡 解決策

sheet.getCharts() が返すのは、単一のグラフではなく「グラフの配列(リスト)」です。 1番目のグラフを指定するために、必ず sheet.getCharts()[0] のようにインデックス番号 [0] を指定してください。

トラップ2:Presentation オブジェクトに対して直接 insertSheetsChart を呼び出してしまう

✕ 間違いコード

var presentation = SlidesApp.openById(presentationId);
// 部屋(Slide)ではなく家(Presentation)に直接入れようとしている!
presentation.insertSheetsChart(sourceChart);

🚨 エラーメッセージ

TypeError: presentation.insertSheetsChart is not a function

💡 解決策

insertSheetsChart() は、Slide(個別のスライドページ・部屋)が持っている専用のメソッドです。 必ず presentation.getSlides()[0] のように、対象のスライドページを取得してから呼び出してください。

トラップ3:対象のシートにグラフが存在しない(charts.length === 0)

スプレッドシート側でグラフを作成していなかったり、シート名を間違えていると、charts[0] を参照した瞬間にエラーになります。

🚨 エラーメッセージ

TypeError: Cannot read property '0' of undefined(または charts[0] が undefined)

💡 解決策

コードを実行する前に、必ず以下のようなチェック文(ガード節)を入れておくと安全です。

if (charts.length === 0) {
  Logger.log("エラー: シート内にグラフが存在しません。スプレッドシートを確認してください。");
  return; // 処理を安全に中断
}

トラップ4:ファイルIDの指定ミス・権限エラー

🚨 エラーメッセージ

Exception: Document 1A2B3C... is missing (or permission denied).

💡 解決策

openById("ID") に渡している文字列に、https://... などの余計なURLが含まれていないか、または前後にスペースが入っていないか確認しましょう。 また、ログインしているGoogleアカウントがそのファイルへの編集権限を持っているかも確認してください。

トラップ5:グラフのサイズが大きすぎてスライドからはみ出す

width や height に 1000 などの大きな数値を指定してしまうと、スライドの画面枠外へグラフが飛び出してしまいます。

💡 解決策

前述の通り、標準スライドの幅は720pt、高さは405ptです。

安全なサイズ指定の目安として、幅:300pt〜500pt、高さ:200pt〜300pt の範囲で調整するとバランスよく収まります!

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

今回は、スプレッドシートのグラフをGoogleスライドへ自動埋め込みする Slide.insertSheetsChart() について徹底解説しました!

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

  1. Slide.insertSheetsChart(sourceChart) でスプレッドシートのグラフをスライドへ一瞬で埋め込める!
  2. スプレッドシート側は sheet.getCharts()[0] で EmbeddedChart オブジェクトを取得する[cite: 1]。
  3. 位置やサイズを整えたい時は insertSheetsChart(sourceChart, left, top, width, height) を使う!
  4. 埋め込んだグラフはスプレッドシートとリンクしているため、データ更新時も .refresh() で最新状態に保てる。

これで、手動でのコピペ作業やグラフの位置合わせといった不毛な作業から完全に解放されますね!

次回予告

スプレッドシートのグラフを埋め込めるようになったら、次に欲しくなるのは「現場の実際の写真(札幌オフィスの活動風景やイベント写真など)」をプレゼン資料に挿入することですよね!

次回(第70回)は、Slide.insertImage() をお届けします!

Drive上にある画像ファイルをスライドへ自動配置するテクニックを解説しますので、ぜひお楽しみに!