GASのエラーを
検知して通知する

function importDailyData() {
  try {
    const sheet = SpreadsheetApp.getActive().getSheetByName("集計");
    if (!sheet) {
      // 想定外の状態は、自分でエラーを投げて止める
      throw new Error("シート「集計」が見つかりません");
    }
    // ここに本来の処理
    sheet.getRange("A1").setValue(new Date());
  } catch (e) {
    // e.message: エラー内容 / e.stack: どの関数の何行目で起きたか
    console.error("importDailyData 失敗: " + e.message + "\n" + e.stack);
    throw e; // 再送出しないと、GASの実行ログ上は「成功」として残る
  } finally {
    // 成功しても失敗しても必ず通る。後片付けはここに書く
    SpreadsheetApp.flush();
  }
}

// アンチパターン1: 握りつぶす
try {
  updateSheet();
} catch (e) {
  // 何も書かない → 失敗しても誰も気づかない
}

// アンチパターン2: メッセージだけ残して止めない
try {
  updateSheet();
} catch (e) {
  console.log("エラー"); // 何が起きたか分からず、処理は先へ進んでしまう
}

// 改善: 記録して、続けるか止めるかを明示的に決める
try {
  updateSheet();
} catch (e) {
  console.error("updateSheet 失敗: " + e.message);
  throw e; // 後続処理が前提を壊すなら止める。飛ばしてよいならthrowせず記録だけ
}

const NOTIFY_TO = "alert@example.com";

// トリガーから呼ぶ関数をこれで包む。通知の書き方を1か所に集約できる
function runWithNotify(jobName, fn) {
  const started = new Date();
  try {
    fn();
    console.log(jobName + " 正常終了 (" + (Date.now() - started.getTime()) + "ms)");
  } catch (e) {
    notifyError(jobName, e);
    throw e; // GASの実行ログにも失敗として残す
  }
}

function notifyError(jobName, e) {
  const subject = "[GASエラー] " + jobName;
  const body = [
    "処理: " + jobName,
    "発生時刻: " + Utilities.formatDate(new Date(), "Asia/Tokyo", "yyyy-MM-dd HH:mm:ss"),
    "内容: " + e.message,
    "",
    "スタックトレース:",
    String(e.stack),
    "",
    "スクリプト: " + SpreadsheetApp.getActive().getUrl(),
  ].join("\n");

  if (shouldNotify(subject + body)) {
    MailApp.sendEmail(NOTIFY_TO, subject, body);
  }
}

// 同じ内容の通知は30分に1回までに絞る
function shouldNotify(content) {
  const cache = CacheService.getScriptCache();
  const key = "err_" + Utilities.base64EncodeWebSafe(
    Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, content)
  );
  if (cache.get(key)) return false;
  cache.put(key, "1", 1800); // 30分
  return true;
}

// トリガーにはこの関数を登録する
function dailyJob() {
  runWithNotify("日次データ取り込み", importDailyData);
}

// 1件の失敗で全体を止めず、失敗した行だけ記録して次へ進む
function processRows() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("対象一覧");
  const values = sheet.getDataRange().getValues();

  const errors = [];
  const results = [];

  for (let i = 1; i < values.length; i++) {
    const row = values[i];
    try {
      results.push([callExternalApi(row[0]), ""]);
    } catch (e) {
      // 行番号を添えて記録する。あとで再実行する範囲がこれで決まる
      errors.push("行" + (i + 1) + ": " + e.message);
      results.push(["", "失敗: " + e.message]);
    }
  }

  // 1行ずつ書くと遅いので、まとめて書き戻す
  if (results.length > 0) {
    sheet.getRange(2, 3, results.length, 2).setValues(results);
  }

  // 全体としては完了扱いだが、失敗が出たことは必ず通知する
  if (errors.length > 0) {
    notifyError(
      "対象一覧の処理（" + errors.length + "/" + results.length + "件失敗）",
      new Error(errors.slice(0, 20).join("\n"))
    );
  }
}

function callExternalApi(id) {
  const res = UrlFetchApp.fetch("https://api.example.com/items/" + id, {
    method: "get",
    // trueにすると、404や500でも例外を投げずにレスポンスを返す
    muteHttpExceptions: true,
  });

  const code = res.getResponseCode();
  const text = res.getContentText();

  if (code === 200) {
    return JSON.parse(text).name;
  }
  if (code === 404) {
    // 業務上ありうる状態なので、エラーにせず空で返す
    return "";
  }
  if (code === 429 || code >= 500) {
    // 時間をおけば直る可能性がある種類。リトライ対象として区別する
    throw new Error("一時エラー(" + code + "): " + text.slice(0, 200));
  }
  // それ以外はリクエスト側の問題。再実行しても同じ結果になる
  throw new Error("リクエストエラー(" + code + "): " + text.slice(0, 200));
}

// エラーを専用シートに残す。メールと違って検索・集計ができる
function logError(jobName, e, target) {
  const ss = SpreadsheetApp.getActive();
  let sheet = ss.getSheetByName("エラーログ");
  if (!sheet) {
    sheet = ss.insertSheet("エラーログ");
    sheet.appendRow(["日時", "処理", "対象", "内容", "スタックトレース"]);
    sheet.setFrozenRows(1);
  }

  sheet.appendRow([
    new Date(),
    jobName,
    target || "",
    e.message,
    String(e.stack).slice(0, 5000), // セルの文字数上限に余裕を持たせる
  ]);

  // 行が増えすぎないよう、古い行を削る
  const max = 1000;
  const extra = sheet.getLastRow() - 1 - max;
  if (extra > 0) {
    sheet.deleteRows(2, extra);
  }
}