【GAS入門#61】Google Slides操作編スタート!SlidesApp.openById()でプレゼンテーションとスライドを指定・取得しよう

前回(第60回)までは「フェーズ6:Google Docs(ドキュメント)操作編」として、札幌オフィスの請求書作成やテンプレート置換、PDF出力などの自動化テクニックを学んできました。ドキュメントをGASで自由自在に扱えるようになると、書類作成の時間が一気に短縮されますよね!

そして今回から、いよいよ新しい章「フェーズ7:Google Slides(スライド)操作編(第61回〜第75回)」へと突入します!

社内会議の月次報告資料、役員会向けのプレゼン資料、顧客向けの提案スライドなど、「毎月・毎週同じようなスライドを手作業で作っている…」という方も多いのではないでしょうか? GASを使えば、スプレッドシートの集計結果から自動でGoogleスライドを生成したり、テキストやグラフを一瞬で最新化したりできます。

記念すべきスライド編の初回となる第61回では、すべての土台となる「操作したいプレゼンテーションを開き、さらにその中の特定の『スライド(ページ)』を指定・取得する方法」を超わかりやすく解説します!

今回も「札幌オフィス月次業績レポート」を題材に、初心者の方がつまずきやすいポイントまで丁寧に紐解いていきます。一緒にマスターしていきましょう!

1. 「家・部屋・家具」の例えで理解するスライドの構造

コードを書き始める前に、本連載でおなじみの「家・部屋・家具」の例えを使って、Googleスライドの全体構造を整理しておきましょう。

第2回で学んだ「Googleスプレッドシート」、第51回で学んだ「Googleドキュメント」と同様に、Googleスライドも明確な階層構造(親子関係)を持っています。

概念現実世界での例えスライドでの対象主なGASのクラス/命令
全体家(建物全体)プレゼンテーションファイル全体(.gslides)SlidesApp.openById() / Presentation
ページ部屋(リビング等)個々のスライド(1枚目のページ、2枚目のページ…)Presentation.getSlides() / Slide
要素家具や装飾テキストボックス、図形、画像、表、グラフなどSlide.getPageElements() / PageElement

プレゼンテーション全体(家)を開いただけでは、どのページ(部屋)のどこにあるテキストボックス(家具)を書き換えればいいのか、プログラムには伝わりません。

そのため、GASでスライドを自動化する際は、必ず以下のステップを踏みます。

  1. SlidesApp.openById() でプレゼンテーション全体(家)を指定して開く
  2. presentation.getSlides() などで目的のスライド(部屋)を指定・取得する
  3. 取得したスライドに対して、テキスト変更や図形追加などの操作(模様替え)を行う

今回は、このステップ1とステップ2に焦点を当てて学びます!

2. 本日学ぶ重要命令(メソッド)一覧

今回マスターする命令は、大きく分けて「プレゼンテーションを指定・取得する命令」と「特定の形式でスライドを指定・取得する命令」の2つです。

① プレゼンテーション全体の指定命令

  • SlidesApp.openById(id)
    IDを指定して、特定のGoogleスライドファイル(Presentation オブジェクト)を開きます。
  • SlidesApp.getActivePresentation()
    スライドのコンテナバインドスクリプト(スライドの「拡張機能」>「Apps Script」から開いた場合)で、現在開いているプレゼンテーションを取得します。

② スライド(ページ)の指定・取得命令

  • presentation.getSlides()
    プレゼンテーションに含まれるすべてのスライドを配列形式で取得します。
  • presentation.getSlides()[0]
    取得したスライドの配列から、インデックス番号(0始まり)で何枚目のスライドかを指定して取得します(例: [0] は1枚目のスライド)。
  • presentation.getSlideById(slideId)
    固有のスライドID(ページID)を直接指定して、特定のスライドピンポイントで取得します。

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

まずは、GASから操作するための練習用Googleスライドを用意しましょう!

手順

  1. 新しいGoogleスライドを作成する
    ブラウザでGoogleドライブを開き、左上の「+ 新規」>「Googleスライド」をクリックして新しいプレゼンテーションを作成します。
  2. ファイル名を変更する
    画面左上の「無題のプレゼンテーション」をダブルクリックし、札幌オフィス月次業績レポートテンプレート に変更します。
  3. スライドを3枚用意する
    左側のスライドサムネイル一覧で改行キー(Enter)などを押し、スライドを合計3枚に増やします。わかりやすいように、それぞれのスライドにテキストを入れておきましょう。
    • 1枚目(表紙):タイトルに「札幌オフィス 月次業績レポート」と入力
    • 2枚目(全社サマリー):タイトルに「今月の全社業績サマリー」と入力
    • 3枚目(部署別詳細):タイトルに「部署別詳細(開発部・営業部)」と入力
  4. プレゼンテーションIDを確認する
    ブラウザのアドレスバーに表示されているURLを確認してください。 URLは以下のような形式になっています。
    https://docs.google.com/presentation/d/1aB2c3D4e5F6g7H8i9J0kLmA_XYZ12345/edit
    この中の /d/ と /edit に挟まれた文字列(上記例では 1aB2c3D4e5F6g7H8i9J0kLmA_XYZ12345)が、このプレゼンテーションの固有ID(ID)です。このあとのコードで使いますので、メモしておきましょう!

4. STEP2:【実践】プレゼンテーションとスライドを指定・取得してみよう

準備ができたら、GASのエディタを開いて実際にコードを書きます。

今回はスプレッドシートの「拡張機能」からではなく、Googleドライブから独立したスタンドアロンスクリプト、または新規GASプロジェクトを作成して実行してみましょう。

1. コードを入力する

Googleドライブの「新規」>「その他」>「Google Apps Script」で新しいエディタを開き、以下のコードを貼り付けます(※YOUR_PRESENTATION_ID の部分は、先ほどメモした実際のプレゼンテーションIDに置き換えてください)。

function openAndGetSlideDemo() {
  // ① プレゼンテーションIDを指定してファイル(家)を開く
  var presentationId = "YOUR_PRESENTATION_ID"; // ここをご自身のプレゼンテーションIDに変更
  var presentation = SlidesApp.openById(presentationId);
  
  // プレゼンテーションタイトルの取得と確認
  var presentationTitle = presentation.getName();
  Logger.log("■ 開いたプレゼンテーション名: " + presentationTitle);
  
  // ② プレゼンテーション内の「全スライド(部屋)」を配列で取得する
  var slides = presentation.getSlides();
  Logger.log("■ 全スライド枚数: " + slides.length + "枚");
  
  // ③【スライド指定方法A】配列のインデックス(0始まり)で指定する(1枚目のスライド)
  var firstSlide = slides[0];
  Logger.log("■ 1枚目のスライドID: " + firstSlide.getObjectId());
  
  // ④【スライド指定方法B】2枚目のスライドを取得してみる
  var secondSlide = slides[1];
  Logger.log("■ 2枚目のスライドID: " + secondSlide.getObjectId());
  
  // ⑤【スライド指定方法C】スライド固有のID(ObjectId)を使ってピンポイント指定する
  var targetSlideId = firstSlide.getObjectId(); // 1枚目のIDを使う例
  var slideById = presentation.getSlideById(targetSlideId);
  Logger.log("■ IDで直接取得したスライドの登録順: " + (slides.indexOf(slideById) + 1) + "枚目のスライド");
}

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

  • SlidesApp.openById(presentationId)
    指定したIDのスライドファイルを呼び出し、変数 presentation に格納します。これにより、プレゼンテーション全体の操作が可能になります。
  • presentation.getSlides()
    ファイルに含まれるすべてのスライドを配列(Array)として返します。配列の要素数は slides.length で確認できます。
  • slides[0] / slides[1]
    JavaScriptの配列ルールに基づき、1枚目のスライドは [0]、2枚目のスライドは [1] と指定します。直感的な「1枚目=1」ではない点に注意してください。
  • slide.getObjectId()
    スライド(1枚のページ)にも、システム上で重複しない固有のID(オブジェクトID)が割り当てられています。
  • presentation.getSlideById(targetSlideId)
    「枚数の順番(インデックス)」が変わる可能性がある場合、このメソッドでスライドIDを直接渡せば、スライドの順番を入れ替えても確実に特定のページを取得できます。

5. STEP3:初回実行と承認プロセスの突破

コードの準備ができたら、画面上部の「保存(フロッピーディスク)」を押し、関数が openAndGetSlideDemo になっていることを確認して「実行」をクリックしましょう。

初回実行時には、第2回や第51回と同様にGoogleセキュリティの承認ポップアップが表示されます。

承認手順(復習)

  1. 「権限を確認」をクリックする。
  2. ご自身のGoogleアカウントを選択する。
  3. 「このアプリは Google で検証されていません」という警告が出たら、左下の「詳細」をクリックする。
  4. 下部に現れる「無題のプロジェクト(安全ではないページ)に移動」をクリックする。
  5. アクセス許可画面で「許可」をクリックする。

承認が成功すると、処理が実行されます!

実行ログの確認

画面下部の「実行ログ」に以下のようなログが表示されていれば大成功です!

情報    ■ 開いたプレゼンテーション名: 札幌オフィス月次業績レポートテンプレート
情報    ■ 全スライド枚数: 3枚
情報    ■ 1枚目のスライドID: g123456789_0_0
情報    ■ 2枚目のスライドID: g123456789_0_1
情報    ■ IDで直接取得したスライドの登録順: 1枚目のスライド

GASが、指定したプレゼンテーションを開き、さらに中の各スライドページまで正確に認識して指定できたことが確認できますね!

6. プレゼンテーション指定とスライド指定の方法まとめ

Googleスライドを扱う際、プレゼンテーション全体の指定と、個別のスライドの指定には複数のアプローチがあります。用途に応じて使い分けられるように整理しておきましょう。

プレゼンテーション(全体)の指定方法

メソッド特徴・用途コード例
SlidesApp.openById(id)【基本・一番推奨】 ファイルIDを指定してどこからでも開く。定型処理やバッチ処理に最適。SlidesApp.openById("ID...")
SlidesApp.openByUrl(url)URLを直接指定して開く。SlidesApp.openByUrl("https://...")
SlidesApp.getActivePresentation()スライド内のApps Scriptから動かすコンテナバインド専用。SlidesApp.getActivePresentation()

スライド(ページ)の指定方法

メソッド特徴・用途コード例
presentation.getSlides()[i]【基本】 順番(0番目=1枚目)で指定。上から順に処理したいループ処理などに便利。var slide1 = presentation.getSlides()[0];
presentation.getSlideById(id)ページ固有のIDで直接指定。スライドの並び順が変わってもエラーになりにくい。var slide = presentation.getSlideById("g123...");
presentation.appendSlide()末尾に新しいスライドを新規追加して、その追加されたスライドを取得する。var newSlide = presentation.appendSlide();

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

スライド操作を始めたばかりの人が必ず一度は遭遇するトラブルと、その解決策をまとめました。

トラップ1:IDにURL全体を指定してしまう

SlidesApp.openById("https://docs.google.com/presentation/d/1aB2c3...") のように、URL全体を渡してしまうミスです。

  • 症状:Exception: Invalid argument: id(引数が無効です)というエラーが発生する。
  • 解決策:openById に渡すのは、URLの中の /d/ と /edit の間にある英数字の文字列(IDのみ)です。URL全体を渡したい場合は SlidesApp.openByUrl() を使いましょう。

トラップ2:スライド指定の「0始まり(ゼロインデックス)」を忘れてしまう

「1枚目のスライドを取得したいから slides[1]」と書いてしまうパターンです。

  • 症状:1枚目ではなく、2枚目のスライドが取得されてしまう。
  • 解決策:プログラミングの配列は常に0始まりです。
    • 1枚目のスライド ➡ slides[0]
    • 2枚目のスライド ➡ slides[1]
    • N枚目のスライド ➡ slides[N - 1]

トラップ3:SpreadsheetApp や DocumentApp の命令と混同する

スプレッドシートやドキュメントを触った後にスライドを触ると、メソッド名を打ち間違えがちです。

  • 症状:TypeError: SlidesApp.getActiveSpreadsheet is not a function のようなエラーが出ます。
  • 解決策:スライド操作の親玉クラスは SlidesApp、取得したオブジェクトは Presentation や Slide です。補完機能(Ctrl + Space)を活用して正しいメソッド名を選択しましょう。

トラップ4:存在しないインデックス番号を指定してエラーになる

3枚しかスライドがないのに slides[3](4枚目を意味する)を指定してしまうとエラーになります。

  • 症状:TypeError: Cannot read properties of undefined
  • 解決策:操作する前に slides.length で合計枚数を確認するか、ループ処理を行う際は安全なインデックス範囲で処理しましょう。

8. まとめ&次回予告

今回は、「フェーズ7:Google Slides(スライド)操作編」の第1歩として、プレゼンテーションの指定(SlidesApp.openById)とスライドの指定(getSlides()[0] や getSlideById)を学びました!

本日の重要ポイント

  1. Googleスライドは「プレゼンテーション(家)> スライド(部屋)> ページ要素(家具)」の階層構造になっている
  2. SlidesApp.openById("ID") でプレゼンテーション全体を開く
  3. presentation.getSlides() で全スライドを配列として取得できる
  4. 1枚目のスライドを指定するには、配列の先頭である slides[0] を使う
  5. スライドの順番変更に影響されないピンポイント指定には getSlideById() が有効

スライドを指定・取得する土台が完成したら、次はいよいよ「スライド内の文字を一括置換・更新する」ステップに進みます!

次回(第62回)は、Presentation.replaceAllText() × プレゼン全体の「{対象月}」や「{オフィス名}」を一括更新 をお届けします。

テンプレートスライド内のプレースホルダー文字列(例: {対象月})を、GASで一瞬で今月の文字列に置き換える実務直結テクニックを解説しますので、ぜひ楽しみに待っていてくださいね!