GASエラー逆引き辞典

💻 コード例:

// 初回はエディタで [▶ 実行] を手動クリックして権限承認
function init() {
  SpreadsheetApp.getActiveSpreadsheet(); // これで権限要求が発生
}

💻 コード例:

// 権限エラーになったら
const ss = SpreadsheetApp.openById('XXX'); // 失敗
// → ファイルのオーナーから「編集者」として共有してもらう

💻 コード例:

// appsscript.json に追加
"oauthScopes": [
  "https://www.googleapis.com/auth/spreadsheets",
  "https://www.googleapis.com/auth/gmail.send"
]

💻 コード例:

// NG
const arr = [1, 2, 3  // ] が抜けている

// OK
const arr = [1, 2, 3];

💻 コード例:

function demo() {
  if (true) {
    const x = 1; // ブロックスコープ
  }
  console.log(x); // ❌ ReferenceError
}

💻 コード例:

// NG
const name = user.profile.name; // userがundefinedだとエラー

// OK
const name = user?.profile?.name ?? '不明';

💻 コード例:

const data = sheet.getRange('A1').getValue(); // 単一値
// ❌ data.map(...)
// ✅ まず配列化
const arr = Array.isArray(data) ? data : [data];

💻 コード例:

// NG
const count = 0;
count = count + 1; // ❌

// OK
let count = 0;
count = count + 1; // ✅

💻 コード例:

const name = 'A';
const name = 'B'; // ❌ 同名で再宣言不可

💻 コード例:

// 進捗を保存して継続
const prop = PropertiesService.getScriptProperties();
let startRow = Number(prop.getProperty('row')) || 1;
// 処理 ...
prop.setProperty('row', nextRow);

💻 コード例:

const remaining = MailApp.getRemainingDailyQuota();
if (remaining < recipients.length) {
  // 翌日に回す処理
  return;
}

💻 コード例:

function fetchWithRetry(url, retries = 3) {
  for (let i = 0; i < retries; i++) {
    try { return UrlFetchApp.fetch(url); }
    catch (e) { Utilities.sleep(Math.pow(2, i) * 1000); }
  }
  throw new Error('fetch failed');
}

💻 コード例:

// トリガーの頻度を見直す
// ❌ 1分ごと（1日1440回）
// ✅ 5-10分ごとでも済むケースが大半

💻 コード例:

// NG: 名前付き範囲が消えているかも
sheet.getRange('MyRange').getValue();

// OK: 数値指定が安全
sheet.getRange(1, 1, sheet.getLastRow(), sheet.getLastColumn());

💻 コード例:

const sheet = ss.getSheetByName('在庫');
if (!sheet) throw new Error('シート「在庫」が見つかりません');

💻 コード例:

// NG
sheet.getRange(0, 1); // ❌ 行は1以上

// OK
sheet.getRange(1, 1);

💻 コード例:

// URLから抜き出す部分
// https://docs.google.com/spreadsheets/d/[ここがID]/edit
const ss = SpreadsheetApp.openById('1AbCdEf...');

💻 コード例:

function listTriggers() {
  const triggers = ScriptApp.getProjectTriggers();
  triggers.forEach(t => console.log(t.getHandlerFunction()));
}

💻 コード例:

// 重複トリガー削除
ScriptApp.getProjectTriggers()
  .filter(t => t.getHandlerFunction() === 'oldFunction')
  .forEach(t => ScriptApp.deleteTrigger(t));

💻 コード例:

// 手動インストール型トリガー作成
ScriptApp.newTrigger('myOnEdit')
  .forSpreadsheet(SpreadsheetApp.getActive())
  .onEdit()
  .create();

💻 コード例:

// 429対策
UrlFetchApp.fetch(url, {
  muteHttpExceptions: true
});
if (res.getResponseCode() === 429) {
  Utilities.sleep(5000);
}

💻 コード例:

const res = UrlFetchApp.fetch(url);
console.log(res.getContentText().slice(0, 200)); // 先頭200文字確認

💻 コード例:

const frozen = Object.freeze({ a: 1 });
const copy = { ...frozen, a: 2 }; // スプレッドでコピー編集

💻 コード例:

const today = Utilities.formatDate(new Date(), 'Asia/Tokyo', 'yyyy-MM-dd');
// 2026-04-22 のように日本時間で取れる

💻 コード例:

const v = sheet.getRange('A1').getValue();
if (v === '' || v === null || v === undefined) {
  // 空セル処理
}