公開日：2日前最終更新日：1日前

GASのtry-catch入門｜元データを守るエラー処理とログの実装例

Xでシェア facebookでシェア LINEでシェア

Gasおじ｜GoogleアカウントをAIエージェント化

先に押さえたい3つの考え方
シートを準備する
コピーして使えるコード
実行手順
try-catchで見落としやすい点
catchで握りつぶさない
バックアップは復元そのものではない
本番データの前にコピーで試す
公開前の確認リスト
まとめ

GAS（Google Apps Script）のtry-catchは、エラーを「なかったこと」にする機能ではありません。失敗した場所を記録し、途中停止したときに原因を追いやすくするための仕組みです。

この記事では、元データを直接書き換えず、バックアップ用シートと処理結果用シートを新しく作る最小例を紹介します。コードは無料で、そのままコピーして試せます。

先に押さえたい3つの考え方

try-catchだけでは、入力ミスや権限不足を防げません。
元データを更新する前に、入力検証とバックアップ方法を決めます。
エラー内容に顧客名やメールアドレスなどの個人情報をそのまま残さないようにします。

今回は「元データ」シートを読み、元データには触れずに次の2シートを作ります。

バックアップ_日時_識別子
処理結果_日時_識別子

シートを準備する

スプレッドシートに「元データ」という名前のシートを作り、1行目を見出しにします。

A列: item_name
B列: amount

2行目以降にサンプルデータを入れてください。amountが数値の行だけ、処理結果へ反映します。

コピーして使えるコード

function processDataSafely() {
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  const sourceSheet = spreadsheet.getSheetByName('元データ');

  if (!sourceSheet) {
    throw new Error('「元データ」シートが見つかりません。');
  }

  const values = sourceSheet.getDataRange().getValues();
  if (values.length < 2) {
    throw new Error('処理対象のデータ行がありません。');
  }

  const headers = values[0];
  if (headers[0] !== 'item_name' || headers[1] !== 'amount') {
    throw new Error('A1をitem_name、B1をamountにしてください。');
  }

  const timestamp = Utilities.formatDate(
    new Date(),
    Session.getScriptTimeZone(),
    'yyyyMMdd_HHmmss'
  );
  const suffix = Utilities.getUuid().slice(0, 8);
  const backupName = `バックアップ_${timestamp}_${suffix}`;
  const resultName = `処理結果_${timestamp}_${suffix}`;

  try {
    const backupSheet = spreadsheet.insertSheet(backupName);
    backupSheet
      .getRange(1, 1, values.length, values[0].length)
      .setValues(values);

    const resultRows = [['item_name', 'amount', 'status', 'processed_at']];

    values.slice(1).forEach((row) => {
      const itemName = String(row[0] || '').trim();
      const amount = Number(row[1]);

      if (!itemName || !Number.isFinite(amount)) {
        resultRows.push([itemName, row[1], '入力不備', timestamp]);
        return;
      }

      resultRows.push([itemName, amount, '確認済み', timestamp]);
    });

    const resultSheet = spreadsheet.insertSheet(resultName);
    resultSheet
      .getRange(1, 1, resultRows.length, resultRows[0].length)
      .setValues(resultRows);

    console.log(`完了: ${resultName}`);
  } catch (error) {
    console.error(`${error.name}: ${error.message}`);
    throw error;
  }
}