【GAS入門#70】スライドに画像を自動挿入!Slide.insertImage()の使い方と位置・サイズ指定のコツ

「毎月のプレゼン資料に、現場の写真やスクリーンショットを1枚ずつ手動で貼り付けるのが面倒…」

「Googleスライドに画像を自動で流し込んで、きれいな配置まで一瞬で終わらせたい!」

プレゼン資料の作成で意外と時間を取られるのが、「画像の挿入と位置・サイズの調整」 ですよね。手動でドラッグ&ドロップして位置を合わせていると、ミリ単位のズレが気になったり、枚数が多いほど途方もない作業になります。

そんなお悩みを一発で解決するのが、GAS(Google Apps Script)の Slide.insertImage() です!

この命令を使えば、Googleドライブに保存された画像ファイルを自動で読み込み、指定したスライドの好きな位置・好きなサイズでピタッと挿入することができます。

第70回となる今回は、「札幌オフィスの活動写真」 をプレゼン資料のスライドに自動配置する実践的なプログラムを作りながら、Slide.insertImage() の基本操作から画像の位置・サイズ指定のテクニック、初心者が必ずハマる注意点まで徹底解説します!

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

Slide.insertImage() は、Googleスライドの指定したページ(Slideオブジェクト)に、画像データを挿入するためのメソッド です。

第61回で学んだ SlidesApp.openById() でプレゼンテーションを開き、操作したいスライドを取得したうえで呼び出します。

コードの基本構造

// 1. スライドを取得する
var slide = presentation.getSlides()[0];

// 2. スライドに画像を挿入する
var image = slide.insertImage(blob);

画像の渡し方(Blobとは?)

Slide.insertImage() の最大のポイントは、カッコの中に渡すデータが「画像のファイル名」や「画像のURL文字列」ではない という点です。

GASでスライドやドキュメントに画像を埋め込むときは、画像をバイナリデータ(生のデータ塊)として扱う 「Blob(ブロブ)」 という形式で渡す必要があります。

Googleドライブ上の画像ファイルから Blob を取り出すには、第41回で学んだ DriveApp を組み合わせて次のように記述します。

// Googleドライブからファイルを取得し、Blob(画像データ)を取り出す
var file = DriveApp.getFileById("画像ファイルのID");
var imageBlob = file.getBlob();

// スライドにBlobを渡して画像を挿入!
slide.insertImage(imageBlob);

一見難しそうに見えますが、「DriveAppでファイルを取得 ➡ .getBlob() でデータ化 ➡ slide.insertImage() で挿入」 という3ステップの型さえ覚えてしまえば簡単です!

2. STEP1:準備!「札幌オフィスの活動写真」とスライドを用意しよう

それでは、実際に動かしながら学んでいきましょう!

今回は「札幌オフィスの月次活動報告プレゼン」を想定し、Googleドライブ上の写真データをGoogleスライドへ自動埋め込みする準備を行います。

手順1:Googleスライドを作成する

  1. Googleドライブを開き、「新規」>「Googleスライド」をクリックして新しいプレゼンテーションを作成します。
  2. プレゼンテーションのタイトルを 「札幌オフィス月次活動報告」 に変更します。
  3. アドレスバーのURLから プレゼンテーションID を確認・コピーしておきます。
    • 例:https://docs.google.com/presentation/d/【ここの英数字がID】/edit

手順2:Googleドライブにテスト画像を保存する

  1. パソコンにあるお好みの画像(例:札幌の景色、オフィス風景、イベント写真など)をGoogleドライブにアップロードします。
  2. アップロードした画像ファイルをクリックして選択し、URLから ファイルID を確認・コピーしておきます。
    • 例:https://drive.google.com/file/d/【ここの英数字がID】/view

これで準備は完了です!

3. STEP2:【実践】Slide.insertImage() でスライドに画像を挿入してみよう!

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

まずは、Googleドライブから写真を取得し、スライドの中央付近に画像を挿入する最もシンプルなコードを動かしてみます。

1. コードを入力する

スプレッドシートや独立したGASエディタ(またはスライドに紐づくエディタ)を開き、以下のコードを貼り付けます。

※ YOUR_PRESENTATION_ID と YOUR_FILE_ID は、先ほど控えたご自身のIDに書き換えてください。

function insertSapporoPhoto() {
  // ① プレゼンテーションと対象のスライド(1枚目)を取得する
  var presentationId = "YOUR_PRESENTATION_ID"; // ご自身のプレゼンID
  var presentation = SlidesApp.openById(presentationId);
  var slide = presentation.getSlides()[0]; // 1枚目のスライド
  
  // ② Googleドライブから「札幌オフィスの活動写真」の画像データ(Blob)を取得する
  var imageFileId = "YOUR_FILE_ID"; // ご自身の画像ファイルID
  var imageFile = DriveApp.getFileById(imageFileId);
  var imageBlob = imageFile.getBlob();
  
  // ③ スライドに画像を挿入する
  var insertedImage = slide.insertImage(imageBlob);
  
  // ④ 完了ログを出力する
  Logger.log("札幌オフィスの活動写真をスライドに挿入しました!");
}

2. 実行手順とセキュリティ承認

  1. エディタ上部の 「保存」 ボタン(フロッピーマーク)を押します。
  2. 関数が insertSapporoPhoto になっていることを確認し、「実行」 をクリックします。
  3. 初回実行時はGoogleドライブやスライドへのアクセス権限を求める「承認ダイアログ」が表示されます。画面の指示に従ってアクセスを「許可」してください。

3. 実行結果の確認

Googleスライドの画面を開いてみましょう。

1枚目のスライドに、Googleドライブに保存していた札幌オフィスの写真がポンッと挿入されていれば大成功です!

4. STEP3:位置とサイズをぴったり整える応用テクニック

デフォルトのまま画像を挿入すると、スライドの左上に配置されたり、画像本来のサイズが大きすぎてスライドからはみ出してしまうことがあります。

実務で使えるプレゼン資料にするためには、「表示位置(座標)」 と 「幅・高さ(サイズ)」 をプログラムから指定する必要があります。

画像の配置とリサイズで使うメソッド

slide.insertImage() を実行すると、返り値として Image(または PageElement)オブジェクト が戻ってきます。この返り値に対して以下のメソッドを使うことで、見た目を自由自在にコントロールできます。

メソッド名役割単位
setLeft(X座標)スライド左端からの横位置を指定ポイント(pt)
setTop(Y座標)スライド上端からの縦位置を指定ポイント(pt)
setWidth(幅)画像の横幅を指定ポイント(pt)
setHeight(高さ)画像の高さを指定ポイント(pt)

※Googleスライドの標準サイズ(16:9)は 幅:720pt、高さ:405pt です。

座標とサイズを指定してきれいに配置する実践コード

スライドの右側に、横幅300ptにリサイズした「札幌オフィスの活動写真」を配置してみましょう!

JavaScript

function insertAndAlignSapporoPhoto() {
  var presentation = SlidesApp.openById("YOUR_PRESENTATION_ID");
  var slide = presentation.getSlides()[0];
  
  // Googleドライブから画像データ(Blob)を取得
  var imageFile = DriveApp.getFileById("YOUR_FILE_ID");
  var imageBlob = imageFile.getBlob();
  
  // ① 座標とサイズを指定して画像を挿入する書き方(オーバーロード)
  // 引数:(blob, left, top, width, height)
  var left = 380;   // X座標:スライド中央よりやや右側
  var top = 80;     // Y座標:上から80pt下の位置
  var width = 300;  // 横幅:300pt
  var height = 200; // 高さ:200pt
  
  // 挿入と同時に位置・サイズを一括指定!
  slide.insertImage(imageBlob, left, top, width, height);
  
  Logger.log("位置とサイズを指定して画像を挿入しました!");
}

💡 画像の縦横比(アスペクト比)を崩さずに拡大縮小するテクニック

幅と高さを固定の数値で指定すると、元画像の縦横比が変わって写真が横伸び・縦伸びしてしまうことがあります。

画像の縦横比をキープしたまま綺麗にサイズ調整したい場合は、一度画像を挿入して元のサイズ(getWidth(), getHeight())を取得し、倍率を計算してセット するのがプロのテクニックです。

JavaScript

function insertImageWithAspectRatio() {
  var presentation = SlidesApp.openById("YOUR_PRESENTATION_ID");
  var slide = presentation.getSlides()[0];
  var imageBlob = DriveApp.getFileById("YOUR_FILE_ID").getBlob();
  
  // まず画像をそのまま挿入
  var img = slide.insertImage(imageBlob);
  
  // 元の幅と高さを取得
  var origWidth = img.getWidth();
  var origHeight = img.getHeight();
  
  // 目標の横幅を300ptにした場合の「縮小率」を計算
  var targetWidth = 300;
  var ratio = targetWidth / origWidth;
  
  // 縦横比を維持したサイズと位置を設定
  img.setWidth(targetWidth);
  img.setHeight(origHeight * ratio); // 比率に合わせて高さを自動計算
  img.setLeft(380);
  img.setTop(100);
}

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

Slide.insertImage() を使う際、プログラミング初心者の方がよく直面するトラブルと対処法をまとめました。

トラップ1:DriveApp.getFileById() で URL を指定してしまう

// ✕ エラーになる書き方(URLを渡している)
var file = DriveApp.getFileById("https://drive.google.com/file/d/12345/view");

// ◯ 正しい書き方(ID文字列のみ渡す)
var file = DriveApp.getFileById("12345");

getFileById() に渡すのは、URL全体ではなく d/ と /view の間にある長い英数字(ファイルID)のみ です。

トラップ2:.getBlob() を挟まずに File オブジェクトを渡してしまう

// ✕ エラーになる書き方(Fileオブジェクトをそのまま渡している)
var file = DriveApp.getFileById("FILE_ID");
slide.insertImage(file); // Exception: Exception: Invalid argument

// ◯ 正しい書き方(.getBlob() で画像データ化する)
var blob = DriveApp.getFileById("FILE_ID").getBlob();
slide.insertImage(blob);

insertImage() が受け取れるのは Blob(または Image / BlobSource) です。必ず .getBlob() を呼び出してバイナリデータに変換しましょう。

トラップ3:Web上の画像URL(https://…)をそのまま挿入しようとする

インターネット上の画像URLを使って直接スライドに埋め込みたい場合は、DriveApp ではなく 第94回等で詳しく扱う UrlFetchApp.fetch(url).getBlob() を使用します。

// Web上の画像をURLから直接スライドに挿入する場合
var imageUrl = "https://example.com/sapporo-office.jpg";
var response = UrlFetchApp.fetch(imageUrl);
var imageBlob = response.getBlob();

slide.insertImage(imageBlob);

トラップ4:画像がほかの図形やテキストボックスの後ろに隠れてしまう

スライド上にテキストボックスや図形(第64回参照)がすでに配置されている場合、あとから挿入した画像と重なって表示が見づらくなることがあります。

その場合は、挿入した画像オブジェクトに対して img.bringToFront()(最前面に移動) や img.sendToBack()(最背面に移動) を実行して重なり順を調整しましょう。

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

今回は、Googleスライドに画像を自動挿入する Slide.insertImage() について詳しく解説しました。

本日の重要ポイント

  1. Slide.insertImage() は Googleスライドに画像を挿入する命令
  2. 画像は DriveApp.getFileById().getBlob() で Blob 形式に変換して渡す
  3. insertImage(blob, left, top, width, height) で挿入と同時に位置・サイズが一括指定できる
  4. 縦横比を崩さないためには、元のサイズから倍率を計算して setWidth() / setHeight() を適用する

スライドへグラフを埋め込む第69回(insertSheetsChart)や、今回の画像挿入(insertImage)を組み合わせれば、毎月の業績レポートや現場の活動報告プレゼンを完全自動で生成できるようになりますね!

次回(第71回)は、Slide.remove() / moveSlide() を解説します!

不要になった下書きスライドを削除したり、作成したスライドの順番を自由自在に並び替えて、最終報告プレゼンを完成させるテクニックを学んでいきましょう。お楽しみに!