GASでスプレッドシート内の文字列を効率的に検索・置換する方法

2020-05-25 / 2025-11-25

Google Apps Script（GAS）を利用すると、スプレッドシート内のテキスト検索や置換作業を簡単に自動化できます。特にcreateTextFinderメソッドは、シート全体や特定の範囲を対象に、柔軟な文字列検索を実現するための強力な機能です。

この記事では、createTextFinderの基本的な使い方から応用テクニックまで、実践的なサンプルコードを交えて詳しく解説します。

Google Apps Script 始め方スプレッドシート活用例を各ショップで検索

楽天市場で探す Amazonで探す Yahoo!ショッピングで探す

createTextFinderとは？

createTextFinderは、スプレッドシート内から特定の文字列を検索するためのGASのメソッドです。以下のように、検索したい文字列を指定するだけで簡単に利用を開始できます。

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const textFinder = spreadsheet.createTextFinder('検索したい文字列');

このメソッドはTextFinderオブジェクトを返します。このオブジェクトが持つ.findAll()や.replaceAllWith()といったメソッドを呼び出すことで、検索結果の取得や文字列の置換といった操作が可能になります。

スプレッドシート内の文字列を検索する

TextFinderオブジェクトを使って文字列を検索し、結果を取得するには主に以下の3つのメソッドがあります。

findAll(): 条件に一致するすべてのセル（Range）を配列で取得します。
findNext(): 現在位置から見て、次に見つかった一致セルを取得します。
findPrevious(): 現在位置から見て、前に見つかった一致セルを取得します。

例えば、スプレッドシート内にあるすべての「重要」という文字列を検索し、そのセルの位置をログに出力するコードは以下のようになります。

const ranges = textFinder.findAll();
ranges.forEach(range => {
  console.log(`「重要」が見つかりました。行: ${range.getRow()}, 列: ${range.getColumn()}`);
});

このように.findAll()を使えば、一致したすべてのセルの行番号と列番号を簡単に取得できます。

文字列を置換する

文字列の置換はさらに簡単です。.replaceAllWith()メソッドを使えば、検索した文字列を一括で置換できます。

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
spreadsheet.createTextFinder('古いキーワード')
  .replaceAllWith('新しいキーワード');

このコードを実行するだけで、シート内にあるすべての「古いキーワード」が「新しいキーワード」に置き換えられます。

また、置換したセルの数を取得したい場合は、以下のように戻り値を変数に格納します。

const replacementCount = textFinder.replaceAllWith('新しいデータ');
console.log(`${replacementCount}件のセルを置換しました。`);

応用編: 高度な検索オプションを使いこなす

createTextFinderは、より高度な検索を実現するための便利なオプションメソッド（チェーンメソッド）を提供しています。

textFinder
  .matchCase(true) // 大文字と小文字を区別する
  .matchEntireCell(true) // セルの内容が完全に一致する場合のみ検索
  .useRegularExpression(true) // 正規表現を使用した検索を有効にする
  .ignoreDiacritics(true); // アクセント記号などを無視する

例えば、電話番号のような特定のパターンを持つ文字列を検索したい場合、正規表現を利用すると非常に便利です。

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const regexFinder = spreadsheet.createTextFinder('\\d{3}-\\d{4}-\\d{4}')
  .useRegularExpression(true)
  .findAll();

上記のコードは、「090-1234-5678」のような形式の電話番号をすべて検索します。

すべてのシートを対象に検索・置換する方法

「スプレッドシート内の全シートに対して、特定の単語を一括で置換したい」という場面はよくあります。その場合は、以下のコードで実現できます。

function replaceAcrossAllSheets() {
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sheets = spreadsheet.getSheets();
  
  sheets.forEach(sheet => {
    // 各シートに対して検索と置換を実行
    sheet.createTextFinder('変更前のテキスト')
      .replaceAllWith('変更後のテキスト');
  });
}