【GAS入門#71】不要な下書きスライドを自動整理!Slide.remove() と moveSlide() で報告書を完成させよう

前回(第70回)は、Slide.insertImage() を使って札幌オフィスの活動写真を指定した位置へキレイに挿入する方法を学びました。写真が入ることで、プレゼン資料が一気に華やかで説得力のあるものになりましたね!

さて、自動化によって各部署のデータや写真を流し込み、スライドを自動生成できるようになると、次に直面するのが「スライドの仕上げ・整理整頓」の課題です。

  • テンプレート内に残っていた「入力用チュートリアル」や「下書き用メモ」のスライドを消したい
  • 動的に増殖させたスライドのうち、データが存在しなかった空のページを削除したい
  • 自動生成後に「今月の業績ハイライト(サマリー)」を、表紙のすぐ直後(2ページ目)に引っ張り上げて並び替えたい

手動でドラッグ&ドロップしたり削除キーを押せば済む話ですが、毎月・毎週発生するレポート作成でそれをやるのはスマートではありません。

第71回となる今回は、スライドの削除を行う Slide.remove() と、ページの順番を自在に入れ替える moveSlide() の2大メソッドを徹底解説します!

1. 本日マスターする2つの主要メソッド

まずは、今回新しく覚える2つの命令の役割と基本構文を確認しましょう。

① Slide.remove()(スライドの削除)

指定したスライド(Slide オブジェクト)をプレゼンテーションから完全に消去します。

// 取得したスライドを削除する
targetSlide.remove();
  • 役割:対象のスライドを削除する
  • 戻り値:なし(void)

② Slide.moveSlide(insertionIndex)(スライドの移動)

指定したスライドを、プレゼンテーション内の目的のページ位置(インデックス)へ移動させます。

// 対象スライドを「先頭(1ページ目)」へ移動する
targetSlide.moveSlide(0);
  • 役割:スライドを指定位置へ並び替える
  • 引数:insertionIndex(移動先の位置。0始まりの数値)

2. 【超重要】スライドのページ番号と「インデックス」の関係

GASでスライドの順番を扱うとき、絶対に忘れてはならないのが「インデックス番号は 0 から始まる」というプログラミングの基本ルールです。

実際のページ順インデックス(insertionIndex)説明
1ページ目0プレゼンテーションの最先頭(表紙など)
2ページ目1表紙の直後(サマリーなど)
3ページ目23番目のスライド
Nページ目N - 1最後のスライド位置

たとえば、「表紙のすぐ後ろ(2ページ目)に持っていきたい!」という場合は、moveSlide(1) と指定します。moveSlide(2) にすると3ページ目になってしまうので注意しましょう!

3. STEP1:事前準備!「札幌オフィス月次業績レポート」の構成

今回は、自動生成中の「札幌オフィス月次業績レポート」に以下のような5枚のスライドが存在している状態を想定します。

【現在のスライド構成】
 1枚目 (index 0) : [表紙] 札幌オフィス 月次業績報告
 2枚目 (index 1) : [下書き] ※作成用の注意事項メモ(不要なので削除したい!)
 3枚目 (index 2) : [実績] 開発部 パフォーマンス
 4枚目 (index 3) : [実績] 営業部 パフォーマンス
 5枚目 (index 4) : [要約] 全社業績ハイライト・総括(重要なので2枚目に移動したい!)

ここからGASを使って、次の2つの仕上げ処理を自動化します。

  1. 2枚目の「[下書き] メモ」スライドを削除する
  2. 末尾にある「全社業績ハイライト」を、表紙の直後(2枚目)に移動する

4. STEP2:【実践】不要スライドの削除と並び替えを実行してみよう

それでは、実際に動作するコードを書いて動かしてみましょう!

1. コードを入力する

Googleスプレッドシートやスタンドアロンスクリプトのエディタを開き、以下のコードを貼り付けます。

※ YOUR_PRESENTATION_ID の部分は、お手持ちのGoogleスライドのIDに置き換えてください。

function cleanupAndReorderSlides() {
  // ① プレゼンテーションを開く
  var presentationId = "YOUR_PRESENTATION_ID";
  var presentation = SlidesApp.openById(presentationId);
  
  // ② 全スライドを配列として取得する
  var slides = presentation.getSlides();
  Logger.log("処理前のスライド枚数: " + slides.length + "枚");

  // ==========================================
  // 処理1:不要な「下書きスライド(2枚目=index 1)」を削除
  // ==========================================
  var draftSlide = slides[1]; // 2枚目のスライドを取得
  draftSlide.remove();
  Logger.log("下書きスライドを削除しました。");

  // ※スライドを削除したため、最新の状態でスライド一覧を取得し直す
  slides = presentation.getSlides();
  Logger.log("削除後のスライド枚数: " + slides.length + "枚");

  // ==========================================
  // 処理2:「業績ハイライト(元5枚目→現在4枚目=index 3)」を2枚目(index 1)へ移動
  // ==========================================
  var summarySlide = slides[3]; // 現在の4枚目(index 3)を取得
  summarySlide.moveSlide(1);    // 表紙の直後(index 1)へ移動!
  
  Logger.log("業績ハイライトスライドを2ページ目へ移動完了しました!");
}

2. コードのポイント解説

  • slides[1].remove();
    配列 slides のインデックス 1(=2枚目のスライド)を指定して .remove() を実行することで、プレゼンテーションからキレイに消去されます。
  • presentation.getSlides() の再取得
    スライドを削除すると、全体のスライド数や各スライドのインデックス番号が変化します。そのため、次の操作を行う前に再度 getSlides() で最新の配列を取得し直すのが安全なテクニックです。
  • summarySlide.moveSlide(1);
    対象のスライドを「インデックス 1(=2ページ目)」のポジションに差し込みます。元々そこにあったスライドは自動的に後ろへ1つずつ押し出されます。

5. STEP3:【実務応用】スライドタイトルを判別して動的に削除&並び替え

実務では、「何枚目が下書きか」があらかじめ決まっていないケースも多くあります。

そこで、「スライド内のテキスト(タイトルなど)を検索し、特定の文字が含まれていたら削除 / 移動する」という、より実践的なプログラムを作成してみましょう!

function smartOrganizeSlides() {
  var presentation = SlidesApp.openById("YOUR_PRESENTATION_ID");
  var slides = presentation.getSlides();

  // -------------------------------------------------------------
  // 応用1:タイトルに「下書き」または「DRAFT」が含まれるスライドを自動一括削除
  // ※削除時のループは必ず「後ろ(末尾)」から回すのが鉄則!
  // -------------------------------------------------------------
  for (var i = slides.length - 1; i >= 0; i--) {
    var slide = slides[i];
    var pageElements = slide.getPageElements();
    
    // スライド内のテキストを走査
    for (var j = 0; j < pageElements.length; j++) {
      if (pageElements[j].getPageElementType() === SlidesApp.PageElementType.SHAPE) {
        var text = pageElements[j].asShape().getText().asString();
        
        if (text.indexOf("下書き") !== -1 || text.indexOf("DRAFT") !== -1) {
          Logger.log((i + 1) + "枚目のスライド(下書き)を自動削除します。");
          slide.remove();
          break; // このスライドは削除したのでループを抜ける
        }
      }
    }
  }

  // -------------------------------------------------------------
  // 応用2:「ハイライト」というタイトルのスライドを探して2ページ目(index 1)に移動
  // -------------------------------------------------------------
  // 削除後の最新スライド一覧を取得
  var updatedSlides = presentation.getSlides();
  
  for (var k = 0; k < updatedSlides.length; k++) {
    var targetSlide = updatedSlides[k];
    var shapes = targetSlide.getShapes();
    
    for (var m = 0; m < shapes.length; m++) {
      var shapeText = shapes[m].getText().asString();
      if (shapeText.indexOf("ハイライト") !== -1) {
        Logger.log("「ハイライト」スライドを発見。2ページ目に移動します。");
        targetSlide.moveSlide(1);
        break;
      }
    }
  }
}

6. 初心者が絶対につまずく「3大トラップ」と解決策

スライドの削除や移動の処理を書く際、多くの人がハマってしまう定番のエラーと回避策をまとめました。

トラップ1:配列の前から順(i = 0)に削除ループを回してインデックスがズレる

スライドをループで削除するときに for (var i = 0; i < slides.length; i++) と書いて削除を行うと、途中でインデックス番号が詰まってズレてしまい、削除しきれなかったりエラーが発生します。

  • 1枚目を削除 ➡ 元の2枚目が「新しい1枚目(index 0)」になる
  • ループの次は i = 1 ➡ 「新しい2枚目(元々3枚目だったもの)」をチェックしてしまう(新しい1枚目がスキップされる!)

【解決策】

要素を削除するループ処理は、必ず 末尾から逆順(for (var i = slides.length - 1; i >= 0; i--)) に回しましょう!後ろから消していけば、手前の要素のインデックス番号は変化しないため安全です。

トラップ2:moveSlide() のインデックス指定を「1始まり」と勘違いする

「3ページ目に移動させたい」と思って moveSlide(3) と書くと、実際には4ページ目に移動してしまいます。

【解決策】

移動させたいページ位置から 「1を引いた数値」 を指定する癖をつけましょう!

  • 1ページ目(先頭)= moveSlide(0)
  • 2ページ目 = moveSlide(1)
  • 3ページ目 = moveSlide(2)

トラップ3:削除済みの Slide オブジェクトを再度操作してエラーになる

slide.remove() を実行した直後に、その slide 変数に対して .insertTextBox() や .moveSlide() などを呼び出すと、以下のエラーが発生します。

Exception: The object has been deleted.(オブジェクトは削除されています)

【解決策】

一度 .remove() したスライドはメモリ上でも操作不能になります。削除したスライド変数には二度と触らないようにし、別のスライドを操作する際は再度 presentation.getSlides() で配列を取得し直しましょう。

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

今回は、プレゼンテーションの仕上げに欠かせない Slide.remove() と moveSlide() の使い方を学びました。

今日の重要ポイント

  • slide.remove() で不要な下書きや空スライドを消去できる
  • slide.moveSlide(index) で自由なページ位置へスライドを並び替えられる
  • ページの位置(インデックス)は 0始まり(1ページ目=0) である
  • 複数のスライドを削除するときは 「逆順ループ(後ろから削除)」 が鉄則!

無駄なページが除去され、最も伝えたいサマリーが2ページ目に配置されたことで、札幌オフィスの月次報告プレゼンは一気に完成度が高まりました!

次回(第72回)は、Presentation.getSlides() をテーマに解説します。