前の担当の方や外注先が作ったGAS(Google Apps Script)が、ある日から動かなくなった方に向けて、直す前にまず見る所と、よく出るエラーの読み方をまとめました。
ココナラで、GASの不具合直しを出品しているテマナシが書いた記事です(終わりに、自分の出品の案内があります)。画面の名前は、2026年11月の物です。Googleの変更で変わることがあります。
■ 見る1:「実行数」のエラーの文
スプレッドシートの「拡張機能」→「Apps Script」を開き、左の「実行数」を押します。いつ、どの関数が動いて、うまくいったか止まったかが並んでいます。いちばん新しい、ステータスが「失敗しました」などの行を押すと、エラーの文が出ます。それをそのまま写しておきます。直す時も、人に頼む時も、この文がいちばんの手がかりになります。
■ 見る2:「トリガー」
左の時計のマーク(トリガー)を押すと、「いつ動くか」の設定が並んでいます。
・一覧が空でも、「無い」とは限りません。トリガーは、作った人のアカウントの画面にしか出ません。前の担当の方が作ったトリガーは、今の方の画面には出ません
・トリガーは、作った人のアカウントで動きます。前の担当の方のアカウントが止まった時や、消えた時は、動かなくなることがあります。自分で作り直す時は、前の方のトリガーが残っていると2回動くことがあります(メールが2通届くなど)。前の方に、その方の画面で消してもらえるかを先に確かめます
・onOpen・onEdit という名前の関数は、この一覧に無くても、名前だけで動きます(シンプルトリガー)。下の「権限がありません」のエラーと関係します
■ 見る3:シートの名前と列
よくある原因が、「シートの名前を変えた」「列を足した・消した」です。コードは名前や列の位置で表を探しているので、変えると見つけられなくなります。
最近、表の形を変えていないかを思い出します。
■ よく出るエラーの読み方(例)
・TypeError: Cannot read properties of null (reading 'getRange')
→ シートが見つからない時によく出ます。コードの中のシートの名前と、今のシートの名前がちがわないかを見ます
・Exception: You do not have permission to call ...(権限がありません)
→ メールを送る、別の表を開く、など許可の要る処理を、許可の無い形で呼んだ時に出ます。
・onEdit・onOpen という名前の関数や、セルに書く自作の関数から呼んでいる時:この形では、許可の要る処理は使えません。手で実行して許可しても直らないので、「トリガー」の画面で作るトリガーに変えるなどの直しが要ります
・コードに、新しい許可の要る処理を足した時:エディタから1回、手で実行して、許可の画面を出します
・Authorization is required to perform that action
→ トリガーで動く時に、トリガーを作った人がまだ許可していないと出ます。トリガーを作った人が、エディタから1回、手で実行して許可します
・Exception: Service invoked too many times for one day
→ メールの送信などで、1日に使える上限を超えた時に出ます。メールは、送った宛先の数で数えます(1日に、ふつうのGoogleアカウントは100、Google Workspace は1,500。2026年11月のGoogleの説明書)。上限は、最初に使ってから24時間で戻ります。待つか、送る宛先の数を減らします
・Exceeded maximum execution time
→ 1回の実行が、上限の6分を超えた時に出ます(セルに書く自作の関数は30秒まで)。一度に扱う行を減らす、1つずつでなくまとめて書き込む、などの直しが要ります
■ 直す前に、必ずすること
・表のコピーを作って、コピーの方で試します(「ファイル」→「コピーを作成」)。ただし、コードの中に元の表のID(長い英数字)や、メールの送り先が書いてあると、コピーで動かしても、元の表に書き込んだり、本当にメールが届いたりします。試す前に、IDをコピーの物に、送り先を自分に変えます
・コードを変える前に、今のコードを全部どこかに写して残します
・人やAIにコードを見せる時は、中のパスワード・APIのキー・トークン・メールアドレス・人の名前を「xxx」に変えます。画面の写真も、右上のアカウントのアドレスや人の名前を隠します。前の担当の方や外注先が作ったコードは、外の人に見せてよいか、契約や会社の決まりを先に確かめます
■ 自分で直すのが大変な方へ
私(テマナシ)は、ココナラで、今あるGASの不具合直しと小さな変更を、合わせて月2件までお受けする月額の出品をしています。コードはトークルームに貼るか、ファイルでお送りいただきます。こちらで同じ形の見本のシートを作って直し、動きを確かめてから、直したコードと貼り方をトークルームでお渡しします。権限・トリガー・Googleの上限など、見本で同じことが起きない不具合は、お客さまのシートで一緒に確かめます(こちらがお客さまのシートに入ることはありません)。止まっていないかの見回りはしないので、止まった時にトークルームでお知らせいただく形です。作業にはAI(Claude)を使います。くわしくは出品ページをご覧ください。