GASエラー一覧｜メッセージ別の原因と対処コード早見表

GAS（Google Apps Script）のエラーは、メッセージの先頭語を見れば「どの層で起きたか」が決まり、調べる場所が1か所に絞れます。 TypeError・ReferenceError・SyntaxError・RangeError は JavaScript のエンジン（V8）が出すもので自分のコードの中に原因があり、それ以外は Google のサービス側が返す例外で、権限・割り当て・管理者設定のどれかに原因があります。

この記事では、エラーメッセージの原文で引ける早見表42件に、日本語訳・原因・直すコードを付けました。あわせて公式の割り当て表、6分の上限を越える処理を分割して続きから再開するコード、トリガーの種類による権限の違い、null と undefined の出どころの判断表を1ページにまとめています。

確認環境（確認日 2026-10-05）：JavaScript 由来のメッセージ文は Node.js 22.22.2（GAS の V8 ランタイムと同じ V8 エンジン）で実際に発生させたものです。エンジンの版によって細かな文言が異なる場合があります。判断の流れ図は Mermaid（@mermaid-js/mermaid-cli 12.0.0）で描画できることを確かめました。Google のサービスが返すメッセージ・割り当ての数値・トリガーの制限は、Google Apps Script 公式ドキュメント（末尾の参考）の記載です。

この記事の結論

• TypeError の多くは「null か undefined にドットを付けた」。reading のあとの名前を手がかりに、その左側の変数を調べます。
• 1回の実行は6分まで。長い処理は「途中の位置を保存 → 時間主導型トリガーで続きを予約」の定型で分割します。
• 単純トリガー（onEdit など）は承認が必要なサービスを呼べず、30秒まで。メール送信などはインストール型トリガーに切り替えます。

GASエラーの早見表（メッセージ原文で引く）

ブラウザのページ内検索（Ctrl+F）にエラーメッセージの一部を貼り付けて探してください。変数名や関数名の部分（sheeet、s.getRnage など）は、手元の名前に読み替えます。

TypeError（値が想定と違う）

ReferenceError（名前が見つからない）

SyntaxError（書き方・JSON の形）

RangeError（値の範囲）

Googleのサービスが返す例外（権限・割り当て・管理者設定）

公式のトラブルシューティングに載っているメッセージです。山かっこの部分には、実際の操作名やURLが入ります。

先頭語で原因の層が決まる理由

GAS のコードは、V8 という JavaScript エンジンの上で動き、そこから SpreadsheetApp や GmailApp といった Google のサービスを呼び出します。エラーを出す場所が2つあるので、メッセージの形も2系統になります。

flowchart TD
    A[エラーメッセージの先頭を見る] --> B{SyntaxError か}
    B -- はい --> B1[書き方の層: かっこ 引用符 全角記号<br>または JSON.parse に渡した文字列]
    B -- いいえ --> C{ReferenceError か}
    C -- はい --> C1[名前の層: つづり 宣言の位置]
    C -- いいえ --> D{TypeError か RangeError か}
    D -- はい --> D1[値の層: null undefined 型違い 無効な日付]
    D -- いいえ --> E[サービスの層: 承認 割り当て<br>トリガーの種類 管理者設定]

値の層のエラーは「昨日は動いたのに今日は止まる」形で現れます。 コードは同じでも、シート名が変わった、空行が増えた、APIの応答が変わった、といったデータの変化で起きるためです。

nullとundefinedの出どころを見分ける

TypeError の No.1〜3 は、メッセージの「of null」と「of undefined」で出どころが分かれます。GAS のメソッドは「見つからない」を null で返すものが多く、JavaScript 自体は「渡されていない・存在しない」を undefined で表します。

次のコードは、GAS のメソッドと同じ値（null・undefined）を返す代役を使って、メッセージの違いを再現したものです。

// null と undefined の出どころを見分ける（GAS の戻り値を同じ値の代役で再現）
const ss = { getSheetByName: (n) => (n === "売上" ? { getName: () => n } : null) };
const props = { getProperty: (k) => null };

function onEdit(e) {
  return e.range;                 // エディタから手動実行すると e は undefined
}

const tests = {
  "無いシート名": () => ss.getSheetByName("売り上げ").getName(),
  "無いプロパティ": () => props.getProperty("API_KEY").trim(),
  "引数なしで onEdit": () => onEdit(),
  "範囲外の行": () => [["a", "b"]][1][0],
  "無いキー": () => ({ user: {} }).user.profile.name,
};
for (const [label, fn] of Object.entries(tests)) {
  try { fn(); } catch (err) { console.log(label, "=>", err.name + ": " + err.message); }
}

実行結果（Node.js 22）:

無いシート名 => TypeError: Cannot read properties of null (reading 'getName')
無いプロパティ => TypeError: Cannot read properties of null (reading 'trim')
引数なしで onEdit => TypeError: Cannot read properties of undefined (reading 'range')
範囲外の行 => TypeError: Cannot read properties of undefined (reading '0')
無いキー => TypeError: Cannot read properties of undefined (reading 'name')

直した形です。null は「=== null で分けて、分かりやすいメッセージで止める」、undefined は「先頭で確認して戻る」か「?. と ?? で既定値にする」と使い分けます。

const sheet = ss.getSheetByName("売り上げ");
console.log(sheet === null ? "シートが見つかりません（名前を確認）" : sheet.getName());

function onEditSafe(e) {
  if (!e || !e.range) { console.log("手動実行のため終了（トリガーから呼ばれたときだけ動く）"); return; }
  return e.range;
}
onEditSafe();
console.log(({ user: {} }).user.profile?.name ?? "(名前なし)");

シートが見つかりません（名前を確認）
手動実行のため終了（トリガーから呼ばれたときだけ動く）
(名前なし)

公式の割り当て表（一般アカウントとWorkspace）

割り当てを越えると、スクリプトは例外を出して止まります。公式ページ「Quotas for Google Services」の記載から、よく当たる項目を抜き出しました。公式ページには、割り当ては予告なく変わることがあると書かれているので、運用前に最新の表を確認してください。

1日あたりの割り当て

1回あたり・1件あたりの上限

表計算ソフトに貼れるタブ区切り版です。

項目  一般アカウント Google Workspace
スクリプトの実行時間  6分/回    6分/回
カスタム関数の実行時間 30秒/回   30秒/回
トリガーの合計実行時間 90分/日   6時間/日
トリガーの数  20/ユーザー/スクリプト   20/ユーザー/スクリプト
メールの宛先数 100/日   1,500/日
メール1通の宛先数   50  50
URL Fetch の呼び出し 20,000/日    100,000/日
プロパティの読み書き  50,000/日    500,000/日

1回の実行時間（6分）は、Workspace でも同じです。Workspace で広がるのは1日あたりの量なので、6分を越える処理はアカウントの種類にかかわらず分割が必要になります。

6分の上限を越える処理を分割して再開するコード

考え方は3つです。(1) 上限より手前で自分から止まる、(2) 次に処理する位置をスクリプトプロパティに保存する、(3) 時間主導型トリガーで続きを予約する。

// 6分の上限を越える処理を、分割して続きから再開する定型
const LIMIT_MS = 4.5 * 60 * 1000;      // 6分より手前で自分から止まる
const KEY = "RESUME_ROW";              // 次に処理する行番号を保存するキー
const HANDLER = "processInChunks";     // 再開時に呼ぶ関数名

function processInChunks() {
  const started = Date.now();
  const props = PropertiesService.getScriptProperties();
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("データ");
  if (sheet === null) throw new Error("シート「データ」が見つかりません");

  const lastRow = sheet.getLastRow();
  let row = Number(props.getProperty(KEY)) || 2;   // 保存が無ければ2行目から
  deleteResumeTriggers_();                         // 前回の再開用トリガーを片付ける

  while (row <= lastRow) {
    if (Date.now() - started > LIMIT_MS) {         // 時間切れが近い → 続きを予約して終了
      props.setProperty(KEY, String(row));
      ScriptApp.newTrigger(HANDLER).timeBased().after(60 * 1000).create();
      console.log("中断: 次は " + row + " 行目から");
      return;
    }
    processRow_(sheet, row);                       // 1行ぶんの処理
    row++;
  }
  props.deleteProperty(KEY);                       // 最後まで終わったら目印を消す
  console.log("完了: " + (lastRow - 1) + " 行");
}

function processRow_(sheet, row) {
  const value = sheet.getRange(row, 1).getValue();
  sheet.getRange(row, 2).setValue("処理済み: " + value);
}

function deleteResumeTriggers_() {
  ScriptApp.getProjectTriggers().forEach(function (t) {
    if (t.getHandlerFunction() === HANDLER) ScriptApp.deleteTrigger(t);
  });
}

使っているメソッド（getProperty・setProperty・deleteProperty、newTrigger、timeBased、after、getProjectTriggers、getHandlerFunction、deleteTrigger、getSheetByName、getLastRow）は、公式リファレンスで名前・引数・戻り値を確認しています。構文は node --check で確かめました。

流れそのものは、GAS のサービスを最小限の代役に置き換え、1行の処理に1分かかる10行のデータを与えて Node.js で動かして確かめました。4.5分を越えたところで止まり、2回目で残りを終えています。

--- 1 回目の実行
中断: 次は 7 行目から
    保存値={"RESUME_ROW":"7"} 再開用トリガー=1
--- 2 回目の実行
完了: 10 行
    保存値={} 再開用トリガー=0
10 行に書き込み

あわせて、1行ずつの getValue／setValue を、getValues／setValues で範囲ごとにまとめると、サービスの呼び出し回数が減り、分割そのものが要らなくなることもあります。setValues に渡す二次元配列は、範囲と同じ行数・列数にそろえます。

単純トリガーとインストール型トリガーの違い

「onEdit の中でメールを送ると止まる」「onOpen が動かない」は、トリガーの種類による制限が原因のことが多い部分です。公式の「Simple Triggers」「Installable Triggers」の記載を表にしました。

doGet(e)・doPost(e) も決まった名前の関数ですが、公式では上の制限の対象外とされています。

どちらを使うかの判断表

時間主導型トリガーをコードで作る例です（公式の書き方）。everyMinutes に指定できるのは 1・5・10・15・30 です。

function createTriggers() {
  ScriptApp.newTrigger("dailyReport").timeBased().everyHours(6).create();
  ScriptApp.newTrigger("dailyReport")
    .timeBased()
    .onWeekDay(ScriptApp.WeekDay.MONDAY)
    .atHour(9)
    .create();
}

止まった場所を早く見つける手順

エラーを受け止めて、原因が分かるメッセージに言い換える書き方です。err.name に先頭語、err.message に本文が入ります。

try {
  null.x;
} catch (err) {
  console.log(err.name, "|", err.message, "|", err instanceof TypeError);
}

TypeError | Cannot read properties of null (reading 'x') | true

GAS では、catch の中で console.error(err.stack) を残し、利用者には throw new Error("シート「データ」が見つかりません") のように日本語で言い直すと、次に見る人が早く原因にたどり着けます。

確かめて分かったこと

• コード中の全角スペースは SyntaxError にならず、全角のセミコロンは SyntaxError（Invalid or unexpected token）になりました。 全角記号が原因のときは、行番号の行を打ち直すのが早道です。
• JSON.parse のメッセージは、渡した中身で3通りに分かれました。 HTML なら Unexpected token と先頭の文字、空文字なら Unexpected end of JSON input、undefined なら "undefined" is not valid JSON です。メッセージから「何が渡ったか」を逆算できます。
• 配列の範囲外は reading のあとに数字が出ます（reading '1' など）。数字が出たら添字、名前が出たらメソッドやプロパティ、と読み分けられます。
• 1回6分の上限は一般アカウントと Workspace で同じで、違うのは1日の合計（トリガーの合計実行時間が90分と6時間）でした。
• 分割と再開のコードは、再開用トリガーを消す処理を先頭に置くと、トリガーが積み上がらないことを代役つきの実行で確かめました（2回目の終了時にトリガー0件）。
• 公式のトラブルシューティングでは、複数の Google アカウントに同時にログインした状態はサポート対象外とされています。承認まわりで説明のつかない動きをするときは、シークレットウィンドウで1つのアカウントだけにして試します。

よくある質問

Q. GASの「TypeError: Cannot read properties of null」とは何ですか？ A. null に対してメソッドやプロパティを使ったときに出るエラーです。GAS では getSheetByName に存在しないシート名を渡した場合が代表で、reading のあとに出る名前（getRange など）の左側にある変数が null になっています。

Q. nullとundefinedの違いは何ですか？ A. GAS のメソッドが「見つからない」と答えたのが null、値がそもそも渡されていない・存在しないのが undefined です。of null ならシート名やキーを、of undefined なら実行方法（手動実行）や配列の範囲を確かめます。

Q. GASの実行時間の上限を越えて止まるときはどうすればよいですか？ A. 処理を分割し、続きの位置を保存して時間主導型トリガーで再開します。1回の実行は6分までで、これは Workspace でも変わりません。先に getValues／setValues でまとめて読み書きし、呼び出し回数を減らすのも有効です。

Q. onEditでメールが送れないときは？ A. 単純トリガーは承認が必要なサービスを呼べないため、インストール型の編集トリガーに切り替えます。関数名を onEdit 以外（例：notifyOnEdit）にして、トリガー画面から「編集時」で登録します。

Q. 「Authorization is required to perform that action」が出たときは？ A. エディタで任意の関数を1回手動実行し、承認画面で許可します。トリガーやサービスとして動く場面では承認画面を出せないため、新しいサービスをコードに足したあとは手動実行での承認が必要です。

まとめ

• 先頭語で層が決まる：SyntaxError は書き方、ReferenceError は名前、TypeError・RangeError は値、それ以外は Google のサービス側（承認・割り当て・管理者設定）。
• TypeError は reading のあとの名前を手がかりに、その左側の変数を調べる。of null は GAS のメソッドの戻り値、of undefined は引数・配列の範囲・無いキー。
• getSheetByName と getProperty は、無いと null を返す。=== null で分けて、分かりやすいメッセージで止める。
• トリガー用の関数は先頭で e を確認する。エディタからの手動実行では e が渡されない。
• 1回の実行は6分、単純トリガーは30秒、カスタム関数は30秒。長い処理は位置を保存して時間主導型トリガーで再開する。
• 承認が必要な処理は、単純トリガーではなくインストール型トリガーで動かす。
• 割り当ての数値は変わることがあるので、公式の表で最新の値を確認する。

参考・出典

• Google Apps Script「Troubleshooting」 https://developers.google.com/apps-script/guides/support/troubleshooting
• Google Apps Script「Quotas for Google Services」 https://developers.google.com/apps-script/guides/services/quotas
• Google Apps Script「Simple Triggers」 https://developers.google.com/apps-script/guides/triggers
• Google Apps Script「Installable Triggers」 https://developers.google.com/apps-script/guides/triggers/installable
• Google Apps Script「Event Objects」 https://developers.google.com/apps-script/guides/triggers/events
• Google Apps Script「V8 Runtime Overview」 https://developers.google.com/apps-script/guides/v8-runtime
• Google Apps Script リファレンス「Class Spreadsheet」「Class Properties」「Class ScriptApp」 https://developers.google.com/apps-script/reference

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。