前回(第72回)は、Presentation.getSlides() を使ってプレゼンテーション内のすべてのスライドを繰り返し処理(ループ処理)し、一括で操作する基礎を学びましたね!
スライドの枚数が増えても、プログラムを使えば一瞬で全ページを走査できるようになり、プレゼン作成自動化の土台がしっかり完成しました。
そして第73回となる今回は、スライド作成自動化のクオリティをさらに一段引き上げる超実践的メソッド Slide.getNotesPage() を徹底解説します!
プレゼン本番で「画面には要点だけを表示し、手元のスピーカーノート(発表者ノート・メモ)に口頭での補足原稿や想定QAを仕込んでおきたい」という場面は多いですよね。
ですが、何十枚もあるスライドのスピーカーノートに、1枚ずつ手作業で原稿をコピペしていくのは本当に大変な作業です……。
今回は、役員会プレゼンや社内報告で大活躍する「スピーカーノートへの原稿自動挿入」を題材に、札幌オフィスの「役員会プレゼン用口頭補足原稿」を全自動で流し込む実践コード を作成します。
仕組みや操作手順はもちろん、初心者が必ずハマる落とし穴まで、どこよりも分かりやすく丁寧に解説していきますので、ぜひ最後まで一緒に学んでいきましょう!
1. そもそも Slide.getNotesPage() とは?
Slide.getNotesPage() は、指定したスライド(Slide オブジェクト)に紐づいている 「ノートページ(NotesPage オブジェクト)」を取得するための命令(メソッド) です。
Googleスライドの画面下部にある「スピーカーノート(発表者用メモ)」の領域は、GAS内部では1つの独立した「ノートページ」として管理されています。
「舞台と控え室」の例えでイメージしよう!
本連載でおなじみの例えで整理してみましょう。
- 【建物(会場)】= プレゼンテーション全体(
SlidesApp.openById()) - 【表舞台のステージ】= スライド(
Slide) - 【舞台裏の控え室・台本メモ】= ノートページ(
NotesPage)★今回の主役!
スライド本体が聴衆に見せる「表のステージ」だとすれば、NotesPage は発表者だけに見える「裏の台本メモ」です。
スピーカーノートに文字を書き込むまでの「4つのステップ」
スプレッドシートの操作(Sheet.getRange().setValue())とは異なり、Googleスライドのノートに文字を入力するには、以下の4つのステップ(階層構造)を順番に辿る必要があります。
| ステップ | 取得するオブジェクト | 使用する主なメソッド | 現実世界でのイメージ |
| STEP 1 | スライド | presentation.getSlides()[0] | 1枚目の「ステージ」を選ぶ |
| STEP 2 | ノートページ | slide.getNotesPage() | そのステージの「裏方メモ帳」を開く |
| STEP 3 | テキスト枠(シェイプ) | notesPage.getSpeakerNotesShape() | メモ帳の中の「原稿書き込み欄」を掴む |
| STEP 4 | テキスト範囲 | shape.getText().setText(...) | 原稿書き込み欄に文字をペンで書く |
最初は「少し段階が多いな……」と感じるかもしれませんが、ドット(.)で順番に繋いでいけばとてもシンプルに書けますので安心してくださいね!
2. STEP1:準備!札幌オフィスの「役員会プレゼン用スライド」を用意しよう
まずは、GASから操作するための練習用Googleスライドを用意しましょう。
手順
- Googleドライブを開き、「新規」>「Googleスプレッドシート」ではなく、「Googleスライド」 を新規作成します。
- プレゼンテーションのタイトル(左上)を 「札幌オフィス月次業績報告プレゼン」 に変更します。
- スライドを 合計3枚 に増やしてください(「+」ボタンまたは
Ctrl + M)。 - それぞれのスライドのタイトル枠に、わかりやすく以下のタイトルを入力しておきましょう。
- 1枚目:札幌オフィス 月次業績報告(全体概要)
- 2枚目:札幌駅前店・大通店 エリア別売上実績
- 3枚目:今期のまとめと来期の展望
- ブラウザのURLバーから、このスライドの 「プレゼンテーションID」 をコピーしておきます。
💡 プレゼンテーションIDの確認方法
URLの
/d/と/editの間にある長い英数字の文字列がIDです。
https://docs.google.com/presentation/d/1a2b3c4d5e6f.../edit
3. STEP2:【実践】指定スライドのスピーカーノートに補足原稿を書き込んでみよう!
準備ができたら、さっそくGASを使って、1枚目のスライドのスピーカーノートに「役員会プレゼン用の口頭補足原稿」を自動で書き込んでみましょう!
1. コードを入力する
スプレッドシートや独立したGASエディタ(またはスライドの「拡張機能」>「Apps Script」)を開き、以下のコードを貼り付けます。
※ YOUR_PRESENTATION_ID の部分は、先ほどコピーしたご自身のスライドIDに書き換えてください。
function addSpeakerNoteToFirstSlide() {
// ① プレゼンテーションIDを指定してファイルを開く(第61回参照)
var presentationId = "YOUR_PRESENTATION_ID";
var presentation = SlidesApp.openById(presentationId);
// ② 1枚目のスライド(Index: 0)を取得する
var slides = presentation.getSlides();
var firstSlide = slides[0];
// ③ 1枚目のスライドから「ノートページ(NotesPage)」を取得する
var notesPage = firstSlide.getNotesPage();
// ④ ノートページ内にある「スピーカーノート枠(Shape)」を取得する
var speakerNotesShape = notesPage.getSpeakerNotesShape();
// ⑤ 補足原稿のテキストを作成する
var scriptText = "【役員会用口頭スクリプト】\n" +
"・冒頭挨拶後、札幌オフィスの当月達成率が120%を超えた点を強調すること。\n" +
"・特に札幌スープカレー事業部のテイクアウト部門が前年比150%と大きく貢献した旨を口頭で補足してください。";
// ⑥ スピーカーノート枠のテキスト領域に書き込む(setText)
speakerNotesShape.getText().setText(scriptText);
// ⑦ ログ出力で確認(第1回参照)
Logger.log("1枚目のスライドにスピーカーノートの原稿を入力しました!");
}
2. コードの1行解説!
var notesPage = firstSlide.getNotesPage();
1枚目のスライドから、発表者用メモが書かれているNotesPageオブジェクトを取り出しています。var speakerNotesShape = notesPage.getSpeakerNotesShape();
ノートページ上に配置されているテキストボックス(Shape)のうち、発表者ノートとして指定されている枠を取得します。speakerNotesShape.getText().setText(scriptText);getText()でテキスト編集用オブジェクト(TextRange)を取り出し、.setText()で原稿の文章を一括書き込みしています。
3. 保存して実行する
- エディタ上部の 「保存(フロッピーマーク)」 をクリックします。
- 実行する関数が
addSpeakerNoteToFirstSlideになっていることを確認し、「実行」 をクリックします。 - 初回実行時は権限の承認画面が出ますので、許可を出してください(承認手順は第2回参照)。
【実行結果の確認】
Googleスライドの画面に戻ってみましょう!
1枚目のスライドの下部にある「スピーカーノート」エリアに、【役員会用口頭スクリプト】 から始まる補足原稿が一瞬で自動入力されていれば大成功です!
4. STEP3:【応用の自動化】全スライドへ「役員会向け口頭発表原稿」を一括自動挿入しよう!
1枚だけに書くのも便利ですが、GASの本領発揮はここからです!
実務では、「あらかじめ用意しておいたスライドごとの原稿リスト(配列やスプレッドシートのデータ)」を読み込んで、全スライドのスピーカーノートへ一括で流し込む処理 がよく使われます。
第72回で学んだ getSlides() のループ処理(forEach や for 文)と組み合わせて、全3枚のスライドに役員会用の発表原稿を一気に挿入してみましょう!
一括自動挿入のサンプルコード
function addAllSpeakerNotes() {
var presentationId = "YOUR_PRESENTATION_ID";
var presentation = SlidesApp.openById(presentationId);
// スライドの全枚数を取得(第72回参照)
var slides = presentation.getSlides();
// 各スライドに挿入したい「口頭発表原稿」のデータ配列を用意
var speechScripts = [
"【1枚目原稿】皆様、本日はお時間いただきありがとうございます。札幌オフィスの月次業績報告を始めます。今期は目標達成率120%と非常に好調な推移となりました。",
"【2枚目原稿】エリア別の内訳です。札幌駅前店は観光客の増加により売上115%達成。大通店は地元のリピーター層に支えられ売上125%と過去最高を更新しました。",
"【3枚目原稿】まとめです。来期は新千歳空港エリアへのポップアップストア出展を計画しております。ご審議のほどよろしくお願いいたします。"
];
// ループ処理で各スライドに原稿を順番に流し込む
for (var i = 0; i < slides.length; i++) {
var slide = slides[i];
var script = speechScripts[i];
// スライドのノートページを取得し、テキストを挿入
var notesPage = slide.getNotesPage();
var speakerNotesShape = notesPage.getSpeakerNotesShape();
// 原稿を書き込む
speakerNotesShape.getText().setText(script);
Logger.log((i + 1) + "枚目のスライドに発表原稿をセットしました。");
}
Logger.log("全スライドへのスピーカーノート一括挿入が完了しました!");
}
実行結果
コードを実行すると、わずか1秒ほどで1枚目・2枚目・3枚目すべてのスライドの下部に、それぞれのページに対応した口頭発表原稿が完璧に挿入されます!
スプレッドシート等で管理している「発表原稿一覧」からデータを読み込むようにカスタマイズすれば、プレゼン資料作成の効率が劇的に向上しますね。
5. 初心者が絶対につまずく!5大トラップと完全対処法
Slide.getNotesPage() を扱う際、プログラミング初心者の方が特にはまりやすいエラーやトラブルを5つ厳選しました。
事前にチェックして、無用なトラブルを防ぎましょう!
トラップ1:slide.setText() と書いて TypeError になる
ついついやってしまいがちなのが、スライドオブジェクトから直接テキストをセットしようとしてしまうミスです。
// ✕ NGな書き方(スライドには直接 setText できません)
slide.setText("原稿テキスト");
// ◯ OKな書き方(段階を踏んで TextRange まで到達させる)
slide.getNotesPage().getSpeakerNotesShape().getText().setText("原稿テキスト");
スライド(ステージ)とノート(裏方メモ)は別物です。必ず getNotesPage() ➡ getSpeakerNotesShape() ➡ getText() のステップを踏むことを意識してください。
トラップ2:setText() を使うと元々あったメモが上書き消去される
setText() は、指定したエリアの文字を完全に上書きします。すでに手入力してあったメモや注意事項がある状態で setText() を実行すると、古い内容が綺麗さっぱり消えてしまいます!
【対処法:既存のノートの後ろに文章を追記したい場合】
上書きではなく「既存のメモを残したまま末尾に追加したい」場合は、.appendText() または .appendParagraph() を使用します。
// 既存のノートの末尾に改行付きで追記する
speakerNotesShape.getText().appendText("\n【追記】質疑応答では粗利益率についても質問が予想されます。");
トラップ3:getSpeakerNotesShape() が null に見える・存在しない?
ごくまれに、特殊なテンプレート等でノートページの初期シェイプが破損している場合、getSpeakerNotesShape() の取得に失敗することがあります。
一般的なGoogleスライドの標準テンプレートであれば基本的に自動生成されていますが、安全にコードを書きたい場合は、以下のように null チェックを入れるとより安全です。
var shape = notesPage.getSpeakerNotesShape();
if (shape) {
shape.getText().setText("原稿");
}
トラップ4:スプレッドシート(SpreadsheetApp)の感覚で setNote() を使おうとしてしまう
スプレッドシートのセルにメモを残すときは Range.setNote()(第40回参照)という命令を使いましたね。
しかし、スライドの発表者ノートは setNote() ではなく getNotesPage().getSpeakerNotesShape().getText().setText() です。
名前や構造が全く異なるため、「スライドのノートはページ内のシェイプ(図形)として存在する」と覚えておきましょう!
トラップ5:IDの指定ミスや権限エラー
SlidesApp.openById("ID") のID部分にURL全体を貼り付けてしまったり、前後のダブルクォーテーションを忘れて構文エラー(SyntaxError)になるケースが多発しています。
IDはURLの中間の文字列だけを正確に抜き出すように注意しましょう。
6. まとめ&次回予告
今回は、Googleスライドの発表者ノートに口頭原稿や補足メモを自動入力する Slide.getNotesPage() を詳しく解説しました!
今日の重要ポイントおさらい
Slide.getNotesPage()でスライドに紐づくノートページオブジェクト(NotesPage)を取得するnotesPage.getSpeakerNotesShape()でスピーカーノート用の枠を取得するshape.getText().setText()で文章を書き込み、appendText()で追記するgetSlides()のループ処理と組み合わせれば、全ページの原稿が一瞬で自動挿入できる!
発表者ノートに適切な原稿や補足データを自動でセットできるようになると、プレゼン本番での言い忘れや説明不足を防ぐことができ、業務の信頼性も大きくアップします!
次回予告
次回(第74回)は、スライド上の図形やグラフ、表などの位置をミリ単位で綺麗にレイアウト調整する PageElement.setLeft() / setTop() を解説します!
「札幌オフィスの業績グラフと詳細表を、スライドの左右ぴったり半分ずつに美しいバランスで自動整列させる」という高度なデザイン自動化テクニックに挑戦します。
プレゼン資料の見た目を一瞬でプロ級に整える必須テクニックですので、次回もぜひお楽しみに!

