【GAS】初心者が出くわすありがちなエラー3選!原因と直し方をやさしく解説
Google Apps Script(GAS)を書き始めたばかりのころ、画面の右下に赤文字でズラッと出でくるエラーメッセージにギクッとしたことはありませんか?
でも大丈夫!エラーは「プログラムからの助けてサイン」です。よくあるミスと修正手順さえ知っておけば、パズル感覚で解決できるようになりますよ!
1. TypeError: Cannot read properties of null (reading ‘…’)
❓ どんな時に起きる?(ミスの原因)
シート名やファイルIDの「タイポ(打ち間違い)」が一番の原因です。「何も存在しない場所(null)」に対して「データを取得して!」と命令してしまっているためエラーになります。
❌ 修正前のコード(NG例)
NGfunction myScript1() {
var ss = SpreadsheetApp.getActiveSpreadsheet();
// 「Sheet1」という名前のシートを取りたいのに「Sheeet1」と打ち間違えている!
var sheet = ss.getSheetByName("Sheeet1");
// 中身が空っぽ(null)のsheetに対して命令を出しているのでエラーが発生!
var lastRow = sheet.getLastRow();
}
⭕ 修正後のコード(OK例)
OKfunction myScript1() {
var ss = SpreadsheetApp.getActiveSpreadsheet();
// 正しいシート名に変更する!
var sheet = ss.getSheetByName("Sheet1");
var lastRow = sheet.getLastRow();
Logger.log("最終行は: " + lastRow + " 行目です");
}
情報: 最終行は: 15 行目です
2. SyntaxError: Unexpected token …
❓ どんな時に起きる?(ミスの原因)
文法(Syntax)のルール違反です。かっこ { } や ( ) の閉じ忘れ、記号の付け忘れ、または**全角スペース**をコード内に混ぜてしまった時によく発生します。
❌ 修正前のコード(NG例)
NGfunction myScript2() {
var score = 80;
if (score >= 60) {
Logger.log("合格!");
// ← 中かっこ「}」を閉じ忘れている!
}
⭕ 修正後のコード(OK例)
OKfunction myScript2() {
var score = 80;
if (score >= 60) {
Logger.log("合格!");
} // ← しっかり閉じる!
}
情報: 合格!
3. ReferenceError: … is not defined
❓ どんな時に起きる?(ミスの原因)
「定義されていない変数(名前のない箱)を使おうとした」時や、大文字・小文字のスペルミスがあった時に起きます(JavaScriptは `message` と `Message` を別のものとして区別します)。
❌ 修正前のコード(NG例)
NGfunction myScript3() {
var msg = "こんにちは!";
// 変数名は「msg」で作ったのに「message」を出力しようとしている!
Logger.log(message);
}
⭕ 修正後のコード(OK例)
OKfunction myScript3() {
var msg = "こんにちは!";
// 作成した変数名「msg」と一致させる!
Logger.log(msg);
}
情報: こんにちは!
💡 まとめ:エラーが出たときのチェックリスト
- スペルミス(タイポ)はないか?(シート名、変数名)
- 大文字と小文字が混ざっていないか?(GASは厳密に区別します)
- かっこ
() {}や引用符""は正しく閉じられているか? - 全角スペースがコード内に入り込んでいないか?
エラーが出ても焦らず、エラーメッセージの行番号(例: at myScript(コード:5))を確認して直していきましょう!

Webサイト運営やデータ分析、業務効率化が好きなWebエンジニア・ブロガーです。
普段はWordPressを使ったサイト制作や、Googleアナリティクス(GA4)、Googleタグマネージャー(GTM)、Search Consoleを活用したアクセス解析を中心に学習・検証しています。
「難しいITやWebの知識を、誰でも理解できるように伝えること」をコンセプトに、このサイト「new-otasuke」を運営しています。
記事では、実際に自分で試した内容や、つまずいたポイント、解決方法をできるだけ分かりやすくまとめています。初心者の方でも安心して実践できるよう、画像や図解を交えながら丁寧に解説することを心掛けています。
最近は特に以下の分野を中心に情報発信しています。
Google Analytics 4(GA4)
Googleタグマネージャー(GTM)
Search Console
SEO対策
WordPress
Power Automate
統計学・データ分析
このサイトが、「困ったときに最初に見に来たくなる場所」になれば嬉しいです。
今後も、Webサイト運営や仕事に役立つ情報を分かりやすく発信していきます。どうぞよろしくお願いいたします。

コメント