【GAS入門#62】プレゼン内の文字を一括置換!Presentation.replaceAllText()の使い方とテンプレート自動生成術

前回(第61回)は、Google Slides(スライド)操作編のスタートとして、SlidesApp.openById() を使って「札幌オフィス月次業績レポートテンプレート」などのスライドファイルをプログラムから開く基本を学びましたね!

「プレゼンテーションファイルをGASで開く鍵」を手に入れたところで、次にやりたくなるのは「テンプレート内の文字を一括で最新情報に書き換えること」ではないでしょうか?

毎月・毎週の報告資料を作成するとき、プレゼンの表題や本文にある「〇月度」「札幌オフィス」「売上達成率」といった文字を、手作業で1ページずつ打ち替えるのはとても大変ですし、修正漏れや誤字の原因にもなります。

そこで第62回となる今回は、プレゼンテーション全体に含まれる特定の文字を一瞬でまとめて置換できる最強メソッド Presentation.replaceAllText() を徹底解説します!

第52回で学んだGoogle Docs(ドキュメント)の Body.replaceText() との共通点や違いにも触れながら、北海道・札幌オフィスの月次レポート作成を題材に、実務でそのまま使えるコードや初心者が絶対につまずく罠まで、どこよりも分かりやすく紐解いていきます!

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

Presentation.replaceAllText() は、指定したプレゼンテーション(スライドファイル全体)の中にあるすべてのテキストボックス、図形(シェイプ)、表(テーブル)、さらにはスピーカーノートに至るまで、指定した文字列(キーワード)を探し出し、別の文字列へ一括で置き換える命令(メソッド)です。

「家・部屋・家具」の例えでスライドの構造を整理しよう!

本連載でおなじみの「家・部屋・家具」の例えを、Google Slidesの構造に当てはめてみましょう。

スライドの概念現実世界での例えGASでの主なオブジェクト
プレゼンテーション全体ビル・建物全体(家)Presentation
各スライド(ページ)各部屋・各フロアSlide
テキストボックス・図形・表部屋の中の家具・掲示板PageElement (TextBox, Shape, Table)

スプレッドシートやGoogle Docsと同様に、Presentation オブジェクトは「建物全体」を指しています。

通常、特定の部屋(Slide)にある特定の看板(TextBox)の文字を変えるには、「部屋を選んで、家具を選んで、文字を書き換える」という細かいステップが必要です。

しかし、今回学ぶ Presentation.replaceAllText() は、建物全体(Presentation)に指示を出し、館内中のすべての掲示板にある文字を一括で張り替えてくれる非常にパワフルな命令なのです!

2. replaceAllText() の基本文法と引数のルール

まずは replaceAllText() の構文と書き方を確認しましょう。

// 基本的な書き方(大文字・小文字を区別しない)
var count = presentation.replaceAllText(findText, replaceText);

// 大文字・小文字を厳密に区別して置換する書き方
var count = presentation.replaceAllText(findText, replaceText, matchCase);

引数(カッコの中身)の解説

  1. findText(第1引数・必須):探したい文字列(置換前のキーワード)
    • 例:"{対象月}" や "{オフィス名}" など。
    • プログラムが置換対象を誤認しないよう、実務では { }(波カッコ)などで囲んだ「プレースホルダー(仮置き文字)」を使うのが鉄則です。
  2. replaceText(第2引数・必須):置き換えたい新しい文字列(置換後のテキスト)
    • 例:"2026年9月度" や "札幌オフィス" など。
  3. matchCase(第3引数・任意):大文字と小文字を厳密に区別するかどうかの設定(true または false)
    • true にすると、"{ABC}" と "{abc}" を別の文字として区別します。
    • 省略した場合(または false の場合)は、大文字・小文字を区別せずに同一視して置換します。

💡 戻り値(返り値)として「置換された件数」が取れる!

replaceAllText() を実行すると、結果として 「プレゼン内で実際に何箇所置き換わったか」を示す数値(整数) が返ってきます。

var count = presentation.replaceAllText("{対象月}", "2026年9月度");
Logger.log(count + " 箇所の文字を置換しました!");
// 実行ログ例: 3 箇所の文字を置換しました!

この戻り値を活用することで、「ちゃんと予定通りの箇所数が置換されたか?」をログでチェックできるため、デバッグやエラー検知に大いに役立ちます!

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

それでは、実際にGASから文字を置換する練習用プレゼンテーション(Google Slides)を用意しましょう!

手順

  1. ブラウザで Googleドライブ を開き、「新規」 > 「Googleスライド」 をクリックして新しいプレゼンテーションを作成します。
  2. 画面左上のファイル名を 「札幌オフィス月次業績レポートテンプレート」 に変更します。
  3. 2枚のスライド(ページ)を用意し、それぞれ以下のようにプレースホルダー入りのテキストを入力してください。

1枚目のスライド(表紙)

  • タイトル枠:{対象月} 札幌オフィス 業績報告
  • サブタイトル枠:拠点:{オフィス名} / 報告者:{作成者名}

2枚目のスライド(本文)

  • 画面上部の「+」ボタンで新しいスライドを追加し、レイアウトを「タイトルと本文」にします。
  • タイトル枠:{対象月} 主なトピックス
  • 本文テキストボックス:・{オフィス名}の当月売上目標の達成率は120%を記録しました。・札幌ドーム近郊でのイベントプロモーションが好評を博しました。・来月の注力領域:{オフィス名}限定スープカレーコラボキャンペーン企画
  1. 作成できたら、ブラウザのURL欄からプレゼンテーションID(https://docs.google.com/presentation/d/ と /edit の間にある長い英数字の文字列)をコピーしておきます。

4. STEP2:【実践】プレゼン内の「{対象月}」「{オフィス名}」が一瞬で変わるコードを書こう!

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

今回は、テンプレート内にある {対象月}、{オフィス名}、{作成者名} の3つのプレースホルダーを、一括で最新の文字列に置き換えます!

1. コードを入力する

任意のGoogleスプレッドシート(または独立型スクリプト)で 「拡張機能」 > 「Apps Script」 を開き、エディタに以下のコードを貼り付けます。

function updateSapporoReportTemplate() {
  // ① 操作したいGoogleスライドのIDを指定する(ご自身のIDに書き換えてください)
  var presentationId = "1a2b3c4d5e6f7g8h9i0j_YOUR_PRESENTATION_ID_HERE";
  
  // ② 第61回で学んだ SlidesApp.openById() でプレゼンテーション(家全体)を開く
  var presentation = SlidesApp.openById(presentationId);
  
  // ③ 置き換えたいデータを用意する
  var targetMonth = "2026年9月度";
  var officeName = "札幌オフィス";
  var authorName = "道産子 太郎";
  
  // ④ replaceAllText() でプレゼン全体のプレースホルダーを一括置換する!
  var countMonth  = presentation.replaceAllText("{対象月}", targetMonth);
  var countOffice = presentation.replaceAllText("{オフィス名}", officeName);
  var countAuthor = presentation.replaceAllText("{作成者名}", authorName);
  
  // ⑤ 置換結果をログに出力して確認する
  Logger.log("=== 置換結果レポート ===");
  Logger.log("・{対象月}   : " + countMonth + " 箇所置換しました");
  Logger.log("・{オフィス名} : " + countOffice + " 箇所置換しました");
  Logger.log("・{作成者名} : " + countAuthor + " 箇所置換しました");
}

2. コードを1行ずつ丁寧に解説!

  • var presentation = SlidesApp.openById(presentationId);
    • 第61回のおさらいですね!指定したIDのプレゼンテーション全体(Presentation オブジェクト)を取得して変数 presentation に入れます。
  • var countMonth = presentation.replaceAllText("{対象月}", targetMonth);
    • プレゼンテーション全ページを検索し、"{対象月}" という文字を見つけたらすべて "2026年9月度" に置換します。置換された箇所数が countMonth に入ります。
  • presentation.replaceAllText("{オフィス名}", officeName);
    • 表紙だけでなく、2枚目のスライドの本文に含まれる3箇所の "{オフィス名}" も一度にまとめて "札幌オフィス" へ書き換えてくれます!

3. 保存して実行する

  1. エディタ上部の 「保存(フロッピーアイコン)」 を押します。
  2. 実行する関数が updateSapporoReportTemplate になっていることを確認し、「実行」 ボタンをクリックします。
  3. 初回実行時は権限の承認ポップアップが出ますので、アクセスを許可してください(第2回参照)。

実行ログの確認

情報    === 置換結果レポート ===
情報    ・{対象月}   : 2 箇所置換しました
情報    ・{オフィス名} : 4 箇所置換しました
情報    ・{作成者名} : 1 箇所置換しました

スライド画面の確認

Googleスライドの画面に戻ってみましょう!

  • 表紙の「{対象月}」が 「2026年9月度」 に変わっている!
  • 「{オフィス名}」が 「札幌オフィス」 に変わっている!
  • 2枚目の本文にある複数の「{オフィス名}」も、もれなく 「札幌オフィス」 に一気に変わっている!

手動でちまちま文字を探して打ち替える手間が、たった1秒のプログラム実行で完了しました!

5. 実務で大活躍!replaceAllText() の応用パターン3選

基本が押さえられたら、現場の自動化業務で即戦力となる発展テクニックを3つ紹介します!

応用①:連想配列(オブジェクト)とループ処理で複数の置換をスマートに一括実行する

置換したいキーワードが10個も20個もある場合、presentation.replaceAllText(...) を何十行も書くのは大変ですよね。

JavaScriptの「オブジェクト(連想配列)」と for...in ループを組み合わせれば、数行のスマートなコードにまとめられます!

function bulkReplaceWithMap() {
  var presentationId = "YOUR_PRESENTATION_ID_HERE";
  var presentation = SlidesApp.openById(presentationId);
  
  // 置換ルールを「"探す文字": "新しい文字"」のペア(オブジェクト)で定義する
  var replaceMap = {
    "{対象月}": "2026年10月度",
    "{オフィス名}": "札幌オフィス",
    "{作成者名}": "サッポロ 花子",
    "{売上目標}": "1,500万円",
    "{達成率}": "125%"
  };
  
  // for...in ループでキーを順番に取り出して一括置換!
  for (var key in replaceMap) {
    var count = presentation.replaceAllText(key, replaceMap[key]);
    Logger.log("置換ルール " + key + " ➡ " + replaceMap[key] + " (" + count + "件)");
  }
}

このパターンを覚えておくと、置換項目が増えても replaceMap の中に1行追加するだけで対応できるようになります!

応用②:スプレッドシートの集計データをプレゼンへ自動反映させる(SS×Slides連携)

実務で最も要望が多いのが、「スプレッドシートで計算した月次売上結果を、ボタン1つでGoogleスライドの月次報告書へ反映させたい」という連携です。

第5回で学んだ Range.getValue() でスプレッドシートからデータを読み取り、それを replaceAllText() に渡すことで、完全自動のレポート生成システムが完成します!

function syncSpreadsheetToSlides() {
  // 1. スプレッドシートからデータを取り出す(第5回の復習!)
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var month = sheet.getRange("B2").getValue();     // 例:"2026年9月度"
  var sales = sheet.getRange("C2").getValue();     // 例:15000000
  var rate  = sheet.getRange("D2").getValue();     // 例:"120%"
  
  // 2. スライドを開いてデータを注入する
  var presentationId = "YOUR_PRESENTATION_ID_HERE";
  var presentation = SlidesApp.openById(presentationId);
  
  presentation.replaceAllText("{対象月}", month);
  presentation.replaceAllText("{売上高}", sales.toLocaleString() + "円"); // 金額を3桁カンマ区切りに
  presentation.replaceAllText("{達成率}", rate);
  
  Logger.log("スプレッドシートのデータをスライド報告書へ反映しました!");
}

応用③:大文字・小文字を厳密に区別する(第3引数の活用)

例えば、プレゼンテーション内に英文のプロダクトコードや英単語が含まれていて、"{SEO}"(大文字)と "{seo}"(小文字)を別々の意味として置換したい場合は、第3引数に true を指定します。

function replaceWithCaseSensitive() {
  var presentation = SlidesApp.openById("YOUR_PRESENTATION_ID_HERE");
  
  // 第3引数に true を指定することで、大文字の {SEO} だけを置換する
  presentation.replaceAllText("{SEO}", "Search Engine Optimization", true);
}

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

Presentation.replaceAllText() を使う際に、プログラミング初心者やGAS学習者が非常によく遭遇するエラーやトラブルを5つ厳選しました。ここで予習しておけば無駄な悩み時間をゼロにできます!

トラップ1:元の「マスターテンプレート」を直接上書き破壊してしまう!

初心者事故率No.1の危険なトラップです!

openById() でテンプレートのプレゼンテーションを直接開き、そのまま replaceAllText() を実行すると、元のテンプレートファイル自体の {対象月} などの文字が消えて「2026年9月度」に書き換わって定着してしまいます。これでは翌月以降、テンプレートとして使えなくなってしまいますよね。

💡 【完全解決策】ドライブでテンプレートを複製してから置換する!

実務では、第44回で学んだ File.makeCopy()(Google Drive操作)を使って、「まずテンプレートをコピーし、生成された新しいコピー先のファイルを置換する」 のが鉄則です!

function generateMonthlyReportSafely() {
  var templateId = "YOUR_TEMPLATE_ID_HERE";
  
  // 1. テンプレートファイルをコピーする(第44回の復習!)
  var templateFile = DriveApp.getFileById(templateId);
  var newFile = templateFile.makeCopy("【完成版】2026年9月度 札幌オフィス業績報告");
  
  // 2. コピーしてできた新しいファイルのIDでスライドを開く
  var presentation = SlidesApp.openById(newFile.getId());
  
  // 3. コピー先ファイルに対して置換を実行!
  presentation.replaceAllText("{対象月}", "2026年9月度");
  
  Logger.log("新しいレポートを作成・置換しました!URL: " + newFile.getUrl());
}

この手順を踏めば、元のテンプレートは常に綺麗なまま保持されるので安心です!

トラップ2:波カッコ { } の全角・半角間違いで置換数が 0 件になる

コードで "{対象月}"(半角の波カッコ)と指定しているのに、スライド側の文字が “{対象月}”(全角の波カッコ)になっていると、GASは全く別の文字と判断して置換してくれません。

解決策

  • ログで返ってくる置換件数が 0 箇所になった場合は、スライド側のプレースホルダー文字をドラッグコピーしてGASコード側に貼り付け、全角・半角が完全に一致しているか確認しましょう。

トラップ3:Google Docs の Body.replaceText() と混同してエラーになる

Docs(ドキュメント)操作編(第52回)を学んだ方がハマりやすい点です。

  • Google Docs:body.replaceText("{対象月}", "9月度") (※引数に正規表現が必要な場合あり)
  • Google Slides:presentation.replaceAllText("{対象月}", "9月度") (※メソッド名に All が入る!)

メソッド名が replaceText ではなく replaceAllText である点に注意しましょう!

トラップ4:画像の中の文字や、グループ化された特殊図形の文字が置換されない

replaceAllText() はプレゼンテーション内のすべてのテキストボックス、図形、表の文字を置換してくれますが、「文字が含まれた画像(JPEG/PNG)」 や、外部ソフトから貼り付けた特殊なベクトルオブジェクト内のテキストは変更できません。

解決策

  • 置き換えたい文字は、必ずGoogleスライド上で編集可能な「テキストボックス」や「図形」として配置しておきましょう。

トラップ5:SlidesApp.getActivePresentation() を使って null エラーになる

スプレッドシートのGASエディタから SlidesApp.getActivePresentation() を実行すると、「アクティブなプレゼンテーションが存在しません(null)」というエラーが発生します。

解決策

  • スプレッドシートや独立型GASから実行する場合は、必ず本記事で解説した通り SlidesApp.openById("スライドのID") を使って指定しましょう!

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

今回は、プレゼンテーション内の文字を一括置換する Presentation.replaceAllText() の使い方を徹底解説しました!

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

  1. Presentation.replaceAllText("{検索文字}", "置換後の文字") でスライド全体の文字を一括更新できる!
  2. 戻り値として「置換された箇所数(件数)」が数値で取れる!
  3. 実務では File.makeCopy() でテンプレートをコピーしてから置換するのが鉄則!
  4. オブジェクト(連想配列)と for...in ループを使えば、大量のプレースホルダーも数行でスマート処理!

これで、毎月発生していた手作業でのプレゼン資料の書き換え作業から完全に解放されますね!

さて、プレゼンの文字を置き換えられるようになったら、次にやりたくなるのは「データの数に応じて、特定のスライドページを自動で複製(ページ増殖)すること」です!

たとえば、「開発部」「営業部」「札幌マーケティング部」といった部署ごとのスライドページを、元の1ページのテンプレートから自動でドンドン増やせたら便利ですよね。

そこで次回(第63回)は、Slide.duplicate() を使ってテンプレートページを複製し、「開発部・営業部」などのページを自動増殖させるテクニック を解説します!

プレゼン自動作成の表現力がさらに大きく広がる回となりますので、ぜひ楽しみに待っていてくださいね!