【GAS入門#72】全スライドを一括操作!Presentation.getSlides()とループ処理(for / forEach)の完全攻略

前回の第71回では、Slide.remove() や moveSlide() を使って、不要な下書きスライドを削除したり、最終報告のページ順を綺麗に並び替えるテクニックを学びましたね。プレゼンの「構成整理」がプログラムで一瞬で完了する快適さを実感していただけたかと思います。

さて、第72回となる今回のテーマは、Google Slides操作編の中でも特に実用性が高く、業務自動化の要となる Presentation.getSlides() です!

プレゼンテーションを作成していると、次のような作業に追われることはありませんか?

  • 「全ページに入っている『2025年』という年度表記を、一括で『2026年』に更新したい…」
  • 「30ページあるスライドの全ページ下部に、一発で『札幌オフィス機密資料』というフッターテキストを入れ込みたい…」
  • 「特定のキーワードが含まれるスライドだけを順番にチェックして、個別に装飾を変えたい…」

手作業で1ページずつめくりながら修正していくのは、時間がかかるだけでなく、修正漏れやミスの原因になりますよね。

今回学ぶ Presentation.getSlides() を使えば、プレゼンテーション内にあるすべてのスライドをプログラム上に「配列(リスト)」として一括取得できます。あとはプログラミングの基本である「ループ処理(繰り返し)」と組み合わせるだけで、何十ページ、何百ページあるスライドの全ページ更新が一瞬で完了します!

今回も、当ブログでおなじみの「札幌オフィス月次業績レポート」を題材に、初心者の方でも迷わず実践できるよう、基礎から応用まで超わかりやすく解説していきますね!

1. そもそも Presentation.getSlides() とは?

Presentation.getSlides()(プレゼンテーション・ゲット・スライド)は、指定したプレゼンテーションファイルに含まれているすべてのスライド(Slideオブジェクト)を順番通りに整列した「配列(Array)」として取得する命令(メソッド)です。

基本的なコードの文法

// プレゼンテーション内の全スライドを配列として取得する
var slides = presentation.getSlides();

「アルバムと写真」の例えでイメージを掴もう!

本連載では、これまで「家・部屋・家具」などの例えでGASの構造を整理してきました。スライド操作においては「アルバム(プレゼンテーション)」と「写真(個々のスライド)」でイメージすると非常に理解しやすくなります。

  • アルバム全体= Presentation オブジェクト(第61回で学んだ SlidesApp.openById() で開いたファイル全体)
  • アルバムの中の1枚の写真= Slide オブジェクト(各ページのこと)
  • 写真が集まったコレクション(写真束)= Presentation.getSlides() で取れる配列

getSlides() を呼び出すと、GASはアルバムからすべての写真を1枚ずつ取り出して、[1枚目の写真, 2枚目の写真, 3枚目の写真, ...] という順番通りの箱(配列)に詰めて渡してくれます。

この「写真の束(配列)」を手に入れれば、あとはJavaScriptの for 文や forEach 文などの繰り返し構文(ループ処理)を使って、「1枚目の写真に処理 ➡ 2枚目の写真に処理 ➡ 3枚目の写真に処理…」 という全自動の連続ループ処理が実現できるのです!

2. 第62回「replaceAllText()」との決定的な違いと使い分け

ここで、当連載を熱心に読んでくださっている方は、ひとつの疑問が浮かぶかもしれません。

「あれ?全スライドの文字を置換するなら、第62回で習った Presentation.replaceAllText() を使えば一発でできるんじゃないの?」

まさにその通りです!非常に鋭い着眼点ですね。

実は、プレゼン全体の文字を単純に置換するだけなら Presentation.replaceAllText() でも可能です。しかし、実務ではPresentation.getSlides() によるループ処理でしか実現できない高度な操作がたくさん存在します。

両者の決定的な違いを比較表で整理してみましょう!

比較項目Presentation.replaceAllText()(第62回)Presentation.getSlides() × ループ処理(今回)
処理の単位プレゼンテーション全体(一括)スライド1枚ずつ(個別コントロール)
単純な文字列置換◯(1行でかけて超簡単)◯(ループ内で実行可能)
条件分岐処理✕(全ページ一律で置換される)◯(「3ページ目だけ」「タイトルに〇〇が含まれるページだけ」など自由自在)
図形・フッター等の動的挿入✕(置換しかできない)◯(全ページまたは特定のページの指定座標にテキストや図形を挿入可能)
進行状況のログ確認✕(何箇所変わったか分からない)◯(「第○スライドの更新完了」とログに細かく記録できる)

つまり、「ファイル全体をまるごと単純置換したいときは第62回の replaceAllText()」「スライドごとに細かく判定したり、フッターや画像を全ページに新しく配置したいときは今回の getSlides() ループ処理」 というように使い分けるのがプロのスマートな設計です!

3. STEP1:準備!「札幌オフィス月次業績レポート」プレゼンを作成しよう

それでは、実際に手元のGoogleスライドを使ってGASを動かす準備をしていきましょう!

手順

  1. ブラウザで Googleドライブ を開き、新しい Googleスライド を作成します。
  2. プレゼンテーションのタイトルを 「札幌オフィス月次業績レポート2025」 に設定します。
  3. スライドを 3枚(または4枚) に増やし、それぞれのページにテスト用テキストを入力しておきます。

【スライドの構成例】

  • 1ページ目(タイトルスライド)
    • タイトル:札幌オフィス 2025年 業績報告会
    • サブタイトル:作成者:札幌事業所 業務管理部
  • 2ページ目(開発部実績)
    • タイトル:開発部 2025年 トピックス
    • 本文:2025年は札幌発の地域マップアプリ開発が順調に推移しました。
  • 3ページ目(営業部実績)
    • タイトル:営業部 2025年 売上実績
    • 本文:2025年Q4の目標達成率は120%を記録しました。
  1. 準備ができたら、ブラウザのURLバーから プレゼンテーションID をコピーしておきます。
    • URL形式:https://docs.google.com/presentation/d/【ここの英数字がID】/edit

4. STEP2:【実践】全スライドを取得して総枚数を確認&基本ループ処理

まずは、Presentation.getSlides() を使ってスライド一覧を取得し、全スライドの枚数と各スライドのIDをログに出力する基本コードを書いてみましょう。

1. スプレッドシートやGASエディタを開く

独立したスタンドアロンスクリプト(または任意のGASエディタ)を開き、以下のコードを貼り付けます。YOUR_PRESENTATION_ID_HERE の部分には、先ほどコピーしたご自身のプレゼンテーションIDを貼り付けてください。

function checkAllSlides() {
  // 1. プレゼンテーションIDを指定してファイルを開く(第61回参照)
  var presentationId = "YOUR_PRESENTATION_ID_HERE";
  var presentation = SlidesApp.openById(presentationId);
  
  // 2. プレゼンテーション内の全スライドを配列として一括取得!
  var slides = presentation.getSlides();
  
  // 3. 取得したスライドの総枚数をログに表示する
  Logger.log("■ プレゼンテーションの総スライド数: " + slides.length + " 枚");
  
  // 4. for文(ループ処理)で1枚ずつスライドを取り出して処理する
  for (var i = 0; i < slides.length; i++) {
    var slide = slides[i]; // i番目のスライド(Slideオブジェクト)を取り出す
    var slideNumber = i + 1; // 人間が見やすいページ番号(1始まり)
    
    // スライドのIDをログに出力してみる
    Logger.log("・ 第 " + slideNumber + " ページ目のスライドID: " + slide.getObjectId());
  }
}

2. 実行結果の確認

コードを保存し、checkAllSlides 関数を実行してみましょう!エディタ下部の「実行ログ」に以下のような結果が出力されれば大成功です。

情報	■ プレゼンテーションの総スライド数: 3 枚
情報	・ 第 1 ページ目のスライドID: g123456789_0_1
情報	・ 第 2 ページ目のスライドID: p2
情報	・ 第 3 ページ目のスライドID: p3

コードの重要ポイント解説!

  • slides.length
    • JavaScriptの配列が持っているプロパティで、配列に入っている要素の数(=スライドの枚数)を自動カウントしてくれます。
  • for (var i = 0; i < slides.length; i++)
    • プログラミングの超基本である for ループです。配列のインデックス(i)は 0からスタート するため、i = 0 から slides.length - 1 まで順番に処理が繰り返されます。
  • var slide = slides[i];
    • 配列 slides の i 番目に入っている1枚のスライド(Slide オブジェクト)を取り出して変数 slide に代入しています。これで、この変数 slide に対して様々な操作ができるようになります!

5. STEP3:【実践応用1】全スライドをループしてテキストを一括置換(「2025年」→「2026年」)

基本のループ処理が理解できたところで、いよいよ本題である「全スライドのテキスト一括置換」に挑戦してみましょう!

新年度の準備などで、レポート内の「2025年」という表記をすべて「2026年」に一括更新したいケースを想定します。

1. コードを入力する

以下のコードをGASエディタに貼り付けて実行してみましょう。

function updateYearInAllSlides() {
  // プレゼンテーションを開く
  var presentationId = "YOUR_PRESENTATION_ID_HERE";
  var presentation = SlidesApp.openById(presentationId);
  
  // 全スライドを配列で取得
  var slides = presentation.getSlides();
  
  // 検索文字列と置換文字列を定義
  var targetText = "2025年";
  var replacementText = "2026年";
  
  Logger.log("=== 年度表記の更新処理を開始します ===");
  
  // 全スライドをループ処理して1枚ずつ置換を実行
  for (var i = 0; i < slides.length; i++) {
    var slide = slides[i];
    var pageNum = i + 1;
    
    // Slideオブジェクトが持つ replaceAllText メソッドを実行!
    var replacedCount = slide.replaceAllText(targetText, replacementText);
    
    Logger.log("第 " + pageNum + " ページ目: 「" + targetText + "」を " + replacedCount + " 箇所置換しました。");
  }
  
  Logger.log("=== すべてのスライドの更新が完了しました! ===");
}

2. 実行結果とスライドの変化を確認する

関数の実行後、ログ画面には次のように表示されます。

情報	=== 年度表記の更新処理を開始します ===
情報	第 1 ページ目: 「2025年」を 1 箇所置換しました。
情報	第 2 ページ目: 「2025年」を 2 箇所置換しました。
情報	第 3 ページ目: 「2025年」を 2 箇所置換しました。
情報	=== すべてのスライドの更新が完了しました! ===

Googleスライドの画面を開いてみてください!

タイトルスライドから2ページ目、3ページ目にいたるまで、すべての「2025年」という文字が一瞬で「2026年」へと書き換わっているはずです!

なぜ slide.replaceAllText() の戻り値が便利なのか?

Slide.replaceAllText() メソッドは、置換を実行すると「そのスライド内で何箇所の文字が置き換わったか」という数値(カウント数)を返してくれます。

これを var replacedCount = ... のように変数で受け取ることで、「どのページで何箇所修正されたか」をログで正確に把握できるようになります。手作業のチェックでは見落としがちなミスも、これなら一目瞭然ですね!

6. STEP4:【実践応用2】全スライドに共通フッターテキストを自動挿入してみよう!

続いて、getSlides() ループ処理の真骨頂である「全スライドへの共通フッターテキスト挿入」を実行してみましょう!

全ページの右下に、統一されたフォーマットで「札幌オフィス機密資料 | 2026」という小さなフッター注記テキストボックスを自動生成して配置します。

1. コードを入力する

第66回で学んだ Slide.insertTextBox() と 第67回で学んだ TextRange の装飾を組み合わせた実践的なコードです。

function addFooterToAllSlides() {
  var presentationId = "YOUR_PRESENTATION_ID_HERE";
  var presentation = SlidesApp.openById(presentationId);
  
  // 全スライドを取得
  var slides = presentation.getSlides();
  
  // フッターに表示したいテキスト
  var footerText = "札幌オフィス機密資料 | 2026";
  
  // 配置する位置とサイズを指定(ポイント単位)
  // スライド右下の座標(位置はプレゼンのサイズに合わせて調整可能)
  var positionLeft = 450; // 左端からの距離
  var positionTop = 360;  // 上端からの距離
  var width = 250;        // テキストボックスの幅
  var height = 25;        // テキストボックスの高さ
  
  Logger.log("=== 全スライドへのフッター挿入を開始します ===");
  
  for (var i = 0; i < slides.length; i++) {
    var slide = slides[i];
    var pageNum = i + 1;
    
    // 1. スライド内にテキストボックスを新規作成(第66回参照)
    var textBox = slide.insertTextBox(footerText, positionLeft, positionTop, width, height);
    
    // 2. テキストの文字サイズや色を小さく控えめに装飾(第67回参照)
    var textRange = textBox.getText();
    textRange.setFontSize(9);                        // 9ptに設定
    textRange.getRuns().setFontColor("#888888");     // 控えめなグレー文字
    
    Logger.log("第 " + pageNum + " ページ目にフッターを挿入しました。");
  }
  
  Logger.log("=== 全ページのフッター配置が完了しました! ===");
}

2. 実行結果の確認

コードを実行すると、一瞬にしてプレゼンテーションの全スライド右下に、綺麗なグレーの小さなフッターテキストが挿入されます!

何十ページもあるプレゼン資料に手動でテキストボックスをコピペして配置を合わせる作業は非常に骨が折れますが、GASならわずか数秒で寸分狂わぬ完璧な位置に全ページ配置してくれます。

7. 発展テクニック:forEachループを使ってモダンでスッキリしたコードを書こう

ここまでは最もオーソドックスな for (var i = 0; i < slides.length; i++) を使って解説してきましたが、JavaScript(GAS)には配列を扱うのにより適した forEach(フォー・イーチ)ループ という記法が存在します。

forEach を使うと、カウンター変数 i や slides[i] のような記述を省略でき、より直感的で読みやすいモダンなコードを書くことができます。

forEach を使った書き換え例

function addFooterModern() {
  var presentation = SlidesApp.openById("YOUR_PRESENTATION_ID_HERE");
  var slides = presentation.getSlides();
  
  // forEachでスマートにループ処理!
  // (slide, index) に1枚のスライドと現在の順番(0始まり)が自動で入る
  slides.forEach(function(slide, index) {
    var pageNum = index + 1;
    
    // 全スライドに処理を実行
    slide.replaceAllText("旧社名", "新社名");
    
    Logger.log("第 " + pageNum + " ページ目の処理が完了しました。");
  });
}

for 文も forEach 文も内部的な動きは同じですので、ご自身が書きやすい・読みやすいと感じる方を選んで使ってみてくださいね!

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

Presentation.getSlides() を使った繰り返し処理で、初心者のプログラムが動かなくなる典型的な「4大トラップ」と解決策をまとめました。エラーが出たときはまずここをチェックしてみてください!

トラップ1:配列に対して直接スライド用メソッドを呼び出してしまう

初心者事故率No.1のミスです!

// ✕ 大間違いの例(TypeError になります)
var slides = presentation.getSlides();
slides.replaceAllText("2025年", "2026年"); 
// エラー:slides.replaceAllText is not a function

【原因と対策】

getSlides() で取得できる slides は、スライドそのものではなく「スライドが詰まった箱(配列)」です。箱に対して「文字を置換して!」と命令しても、GASは「箱にはそんな機能はありません!」と怒ってしまいます。

必ず for 文や forEach 文で var slide = slides[i]; のように「1枚のスライド(Slideオブジェクト)」を取り出してから 命令を実行してください。

トラップ2:配列の「0始まり(インデックス)」と「ページ番号」の混乱

プログラミングの配列は 0番目からカウント されます。

  • slides[0] ➡ 1ページ目のスライド
  • slides[1] ➡ 2ページ目のスライド
  • slides[2] ➡ 3ページ目のスライド

ログ等で「第○ページ目」と表示させたいときに Logger.log("第 " + i + " ページ") と書いてしまうと、1ページ目が「第0ページ」と表示されて頭が混乱してしまいます。

人間が見るページ番号を表示するときは、var pageNum = i + 1; のように + 1 した数値を使うのがお約束です!

トラップ3:Presentation.getSlides() の末尾カッコ () 忘れ

GASの命令(メソッド)の語尾には、実行の合図である半角カッコ () が必須です。

// ✕ カッコがない(エラーや意図しない動作の原因)
var slides = presentation.getSlides;

// ◯ 正しい書き方
var slides = presentation.getSlides();

カッコを忘れると、関数オブジェクトそのものが変数に入ってしまい、slides.length が undefined になってループが1回も動かずに終了してしまいます。

トラップ4:スライド枚数が多すぎてGASの「6分間の実行時間制限」に引っかかる

Google Apps Scriptには、無料のアカウントの場合「1回の実行時間は最大6分まで」という制限があります。

100ページを超えるような超巨大なプレゼンテーションに対して、各ページで重い画像処理や複雑な図形生成ループを行うと、処理が終わらずにタイムアウトエラーが発生することがあります。

【対策】

  • 処理が重い場合は、スライドの範囲を分割して実行する(例:前半50ページ、後半50ページ)
  • 不要なログ出力や無駄な処理をループ内から極力削ぎ落とす

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

今回は、Googleスライド内のすべてのページを一括取得して巡回処理する Presentation.getSlides() の使い方を徹底解説しました。

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

  1. Presentation.getSlides() は全スライドを「配列(Array)」として取得する命令
  2. for 文や forEach 文と組み合わせることで、何十ページあるスライドも全自動でループ処理できる
  3. 単純な全体置換は第62回の replaceAllText()、スライドごとの動的挿入や個別処理は今回の getSlides() ループと使い分ける
  4. 取得した slides は配列なので、必ず slides[i] で単一のスライドを取り出してから操作する

プレゼンテーション内のすべてのページを自由自在にプログラムで巡回できるようになると、プレゼン作成の自動化レベルが一気に跳ね上がりますね!

次回予告

次回(第73回)は、プレゼンターの強い味方である「スピーカーノート(発表者用メモ)」をプログラムから操作する Slide.getNotesPage() を解説します!

「各スライドのスピーカーノートに、役員会プレゼン用の口頭補足原稿やデータ根拠を自動で流し込む」という、実務で超役立つプロレベルの自動化テクニックをご紹介します。ぜひ次回もお楽しみに!