【GAS入門#52】Googleドキュメントの文字を自動置換!Body.replaceText()の使い方とテンプレート活用術

前回(第51回)は、Googleドキュメント操作編(フェーズ6)の第一歩として、DocumentApp.openById() を使って特定のドキュメント(「札幌オフィス請求書テンプレート」)をプログラムから開く方法を学びましたね!

ドキュメントを開けるようになったら、次にやりたくなるのは「テンプレート内の指定した文字(置き換え用マーク)を、顧客名や日付などの正しいデータに一気に書き換えること」ではないでしょうか?

手作業で「コピー&ペースト」や「検索と置換」を繰り返すと、入力ミスや宛先の指定ミスなどのうっかり事故が起きがちです。しかし、GASを使えば一瞬で何百箇所もの文字を正確に自動置換できます。

第52回となる今回は、Googleドキュメント内のテキストを一括置換する超重要メソッド Body.replaceText() を徹底解説します!

札幌オフィスの請求書作成業務を題材に、基本的な書き方から、初心者が100%ハマる「正規表現(エスケープ)の罠」、実務で差がつくテクニックまで、どこよりも分かりやすく丁寧に解説していきます!

1. そもそも Body.replaceText() とは?

Body.replaceText() は、Googleドキュメントの本文(Body)の中にある特定の文字(検索パターン)を探し出し、別の文字(置換文字)へ一括で置き換える命令(メソッド)です。

「ドキュメント・本文・テキスト」の構造を理解しよう!

まずは、GoogleドキュメントにおけるGASの階層構造をおさらいしておきましょう。

  • 【ドキュメント全体】= Document(DocumentApp.openById() で取得)
  • 【本文エリア】= Body(doc.getBody() で取得)★今回の主役!
  • 【文字や段落】= Paragraph / Text(Bodyの中にある個々の要素)
// 1. ドキュメントを開く(家に入る)
var doc = DocumentApp.openById("ドキュメントのID");

// 2. ドキュメントの「本文(Body)」を取得する(部屋に入る)
var body = doc.getBody();

// 3. 本文の中の文字を一括置換する(壁紙や文字を貼り替える)
body.replaceText("【旧テキスト】", "【新テキスト】");

なぜ Document ではなく Body に対して命令を出すの?

スプレッドシートの時(Sheet.getRange()など)と同様に、Googleドキュメントでも「どの領域の文字を書き換えるか」をGASに指示する必要があります。

ドキュメントには「本文(Body)」のほかに、「ヘッダー(Header)」や「フッター(Footer)」といった異なるエリアが存在します。そのため、通常文章が書いてあるメイン部分の文字を置換したいときは、まず doc.getBody() で本文エリアを取り出し、その body に対して replaceText() を実行するのが基本ルールです。

2. テンプレート置換が業務効率化のキーになる理由

実務でGoogleドキュメントを自動化する際、最もよく使われる手法が「テンプレート方式」です。

  1. あらかじめデザインやレイアウトを整えたドキュメントを用意する
  2. 変更したい部分に {請求先会社名} や {請求日} のような目印(プレースホルダー)を入れておく
  3. GASの replaceText() で目印を実際のデータに一括置換する

ゼロからプログラムで段落を作ったり文字サイズを変えたりして書類を組み立てるよりも、元となる綺麗なテンプレートの文字だけをGASで置換する方が、はるかに簡単で美しい書類が作成できるのです!

3. STEP1:準備!「札幌オフィス請求書テンプレート」を作成しよう

それでは、実際にGASから操作するための練習用ドキュメントを用意しましょう!

手順

  1. Googleドライブ を開き、「新規」>「Google ドキュメント」をクリックします。
  2. ドキュメントのタイトルを 「札幌オフィス請求書テンプレート」 に変更します。
  3. ドキュメントの本文エリアに、以下のテキストをそのままコピー&ペーストしてください。
請求書

{請求先会社名} 御中

発注いただき誠にありがとうございます。
下記の通りご請求申し上げます。

----------------------------------------
請求日:{請求日}
ご請求金額:{合計金額}
----------------------------------------

■ お問い合わせ窓口
札幌オフィス 担当:佐藤
  1. アドレスバー(URL)を確認し、ドキュメントID をメモしておきます。
    • URL例:https://docs.google.com/document/d/1ABC123xyz_SampleID_456/edit
    • /d/ と /edit の間にある英数字の長い文字列がドキュメントIDです。

4. STEP2:【実践】コードを書いて一括置換してみよう!

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

今回は、テンプレート内の {請求先会社名}、{請求日}、{合計金額} の3項目を、札幌の取引先データに自動置換してみます!

1. 独立型スクリプト(またはスプレッドシート付きGAS)を開く

Googleドライブの「新規」>「その他」>「Google Apps Script」から新しいエディタを開き、以下のコードを入力します(※YOUR_DOCUMENT_ID の部分は、先ほどメモしたご自身のドキュメントIDに書き換えてください)。

function replaceInvoiceTemplate() {
  // ① テンプレートドキュメントをIDで指定して開く(第51回の復習!)
  var docId = "YOUR_DOCUMENT_ID"; 
  var doc = DocumentApp.openById(docId);
  
  // ② ドキュメントの本文(Body)を取得する
  var body = doc.getBody();
  
  // ③ プレースホルダー(目印文字)を実際のデータに置換する
  // ※ エスケープ処理(\\)が必要な点に注意!
  body.replaceText("\\{請求先会社名\\}", "株式会社札幌スープカレー本舗");
  body.replaceText("\\{請求日\\}", "2026年10月1日");
  body.replaceText("\\{合計金額\\}", "154,000円");
  
  // ④ 処理完了をログに出力
  Logger.log("請求書の置換処理が正常に完了しました!");
}

2. 保存と実行

  1. 画面上部の 「保存(フロッピーアイコン)」 をクリックします。
  2. 関数が replaceInvoiceTemplate になっていることを確認し、「実行」 ボタンを押します。
  3. 初回実行時はGoogleのセキュリティ承認画面が出ますので、アクセスを許可してください(承認手順は第2回などを参照)。

3. 実行結果の確認

Googleドキュメントの画面に戻って確認してみましょう!

請求書

株式会社札幌スープカレー本舗 御中

発注いただき誠にありがとうございます。
下記の通りご請求申し上げます。

----------------------------------------
請求日:2026年10月1日
ご請求金額:154,000円
----------------------------------------

■ お問い合わせ窓口
札幌オフィス 担当:佐藤

目印だった {請求先会社名} や {請求日} が、一瞬で見事に本物のデータへ置き換わりましたね!

5. 【超重要】初心者が100%つまずく「正規表現の記号エスケープ」とは?

上記のコードを見て、勘のいい方は「なぜ {請求先会社名} ではなく \\{請求先会社名\\} と斜線(バックスラッシュ/円マーク)を2つ書いているの?」と疑問に思ったのではないでしょうか?

こここそが、Body.replaceText() を使う上で最大の落とし穴であり、最もエラーが起きやすいポイントです!

replaceText() の検索文字は「正規表現(Regex)」として扱われる!

実は、replaceText(searchPattern, replacement) の第1引数(検索文字)は、単なる普通の文字列ではなく、プログラミングの「正規表現(Regular Expression)」というルールで解析されます。

正規表現の世界では、{ や }、(、)、[、]、?、+、* などの記号は、特別な意味を持つ「特殊文字(メタ文字)」として扱われます。

(例えば {1,3} は「直前の文字を1〜3回繰り返す」という意味になります)

そのため、打ち打ちでそのまま body.replaceText("{請求先会社名}", "...") と書くと、GASは「おや?この { は繰り返しの記号かな?」と勘違いしてしまい、エラーが発生するか、文字を見つけられずに無視されてしまうのです。

対処法:\\(エスケープシーケンス)を直前につける!

「これは特殊な命令記号ではなく、普通の文字の『{』として探してね!」とGASに教えてあげる作業をエスケープと呼びます。

JavaScript/GASの文字列の中では、バックスラッシュ(環境によっては円マーク ¥)を2つ付けて \\{ および \\} と書くことで、記号としての括弧を探すことができます。

置換したい目印記号コードでの書き方(エスケープ後)解説
{請求先会社名}"\\{請求先会社名\\}"{ と } の前に \\ を付ける
[担当者名]"\\[担当者名\\]"[ と ] の前に \\ を付ける
(日付)"\\(日付\\)"( と ) の前に \\ を付ける

💡 エスケープが面倒なら「【 】」や「% %」を使うのも手!

「毎回 \\{ と書くのはややこしい…」という場合は、テンプレート側の目印記号に特殊文字を使わず、【請求先会社名】 や %請求先会社名% のような記号を使うのも非常におすすめです!

// 「【 】」を使えばエスケープ不要でスッキリ書ける!
body.replaceText("【請求先会社名】", "株式会社札幌スープカレー本舗");

6. 実務で役立つ応用!スプレッドシートのリストから一括で請求書を作成しよう

実際の現場では、スプレッドシートに入力された顧客リスト(1行目:道産子フーズ、2行目:札幌グランドホテル…)を読み込んで、人数分の請求書ドキュメントを自動で連続作成するという使い方が定番です。

これまでに学んだ「スプレッドシート操作(フェーズ1〜2)」と「Google Drive操作(フェーズ5)」を組み合わせた実践コードのイメージを見てみましょう!

function generateMultipleInvoices() {
  // 1. 元となるテンプレートドキュメントと保存先フォルダの準備
  var templateId = "YOUR_TEMPLATE_DOC_ID";
  var templateFile = DriveApp.getFileById(templateId);
  var targetFolder = DriveApp.getFolderById("YOUR_FOLDER_ID"); // 保存先フォルダ
  
  // 2. スプレッドシートから請求データ(配列)を取得する(第13回 Range.getValues() の復習!)
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var data = sheet.getRange("A2:C4").getValues(); // A列:会社名, B列:日付, C列:金額
  
  // 3. ループ処理で人数分のドキュメントをコピー生成&置換!
  for (var i = 0; i < data.length; i++) {
    var companyName = data[i][0];
    var dateText    = data[i][1];
    var amountText  = data[i][2];
    
    // テンプレートをコピーして新しいファイルを作成(第44回 File.makeCopy() の復習!)
    var newFile = templateFile.makeCopy("請求書_" + companyName, targetFolder);
    
    // コピーした新しいドキュメントを開いて本文を置換
    var newDoc = DocumentApp.openById(newFile.getId());
    var body = newDoc.getBody();
    
    body.replaceText("【請求先会社名】", companyName);
    body.replaceText("【請求日】", dateText);
    body.replaceText("【合計金額】", amountText);
    
    // 変更を保存して閉じる(※GASが自動で行いますが明示的にも可能)
  }
  
  Logger.log("すべての請求書コピー&置換が完了しました!");
}

このように、過去に学んだ知識(DriveApp, SpreadsheetApp)と今回の replaceText() がガッチャンコすることで、手作業なら数時間かかる請求書作成がわずか数秒で完結するようになります!

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

Body.replaceText() を使う際によく発生するエラーやトラブルと、その解決策をまとめました。

トラップ1:doc.replaceText() と書いて TypeError になる

  • エラー内容: TypeError: doc.replaceText is not a function
  • 原因: replaceText() は Document(全体)のメソッドではなく、Body(本文)のメソッドです。
  • 解決策: 必ず var body = doc.getBody(); を挟み、body.replaceText(...) と記述しましょう。

トラップ2:置換されずにそのまま残ってしまう(全角・半角・スペースの違い)

  • 原因: テンプレート側の文字が { 請求日 }(スペースあり)になっているのに、コード側で "{請求日}"(スペースなし)と指定しているケースです。
  • 解決策: 大文字・小文字、全角・半角(英数)、スペースの有無は厳密に区別されます。テンプレートの文字をそのままコードへコピー&ペーストして指定しましょう。

トラップ3:{} のエスケープ忘れで SyntaxError: Invalid regular expression が出る

  • 原因: 正規表現の特殊文字である {} や [] をそのまま指定したことによる構文エラーです。
  • 解決策: \\{ のようにエスケープするか、目印を 【請求先会社名】 などの記号に変更しましょう。

トラップ4:テンプレート本体が直接上書きされてしまう

  • 原因: makeCopy()(コピー作成)を行わずに、テンプレートファイルそのものを DocumentApp.openById() で開いて replaceText() を実行してしまうケースです。
  • 解決策: 2回目以降に置換用の目印(【請求先会社名】)が消えて無くなってしまいます! 実務では必ず File.makeCopy() で複製を作ってから、複製したファイルを置換する 運用の徹底が重要です。

トラップ5:数値データをそのまま渡してエラーになる

  • 原因: replaceText("【金額】", 154000) のように、置換後の値に数値(Number型)をそのまま渡すとエラーになる場合があります。
  • 解決策: replaceText() の第2引数(置き換える文字)は文字列(String型)である必要があります。数字を渡すときは String(154000) や "" + 154000、または "154,000円" のように文字列に変換して渡しましょう。

8. まとめ&次回予告

今回は、Googleドキュメント内の文字を自動で一括置換する Body.replaceText() について解説しました。

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

  1. doc.getBody() で本文(Body)を取得してから body.replaceText() を実行する
  2. テンプレート内の目印(プレースホルダー)を置換するのが自動化の鉄板パターン
  3. {} や [] などの記号は正規表現のエスケープ(\\)が必要になる
  4. エスケープが面倒なら 【置換文字】 を使うとコードがシンプルになる
  5. 置換後のデータは必ず「文字列(String)」形式で指定する

これで、テンプレート文書内の文字をプログラムから自由自在に書き換えられるようになりましたね!

しかし、請求書や契約書を作成していると、「テンプレートの文字を置き換えるだけでなく、文章の末尾に『振込先口座案内』や『特記事項』の新しい段落を動的に追加したい!」という場面も出てきます。

そこで次回(第53回)は、ドキュメントの末尾に新しい段落(パラグラフ)を追加する Body.appendParagraph() を解説します!

文章の追加や改行のコントロールを覚えて、より柔軟で豊かなドキュメント自動生成テクニックを身につけていきましょう。次回もぜひお楽しみに!