GAS『Invalid Argument: Expected』の原因と対処法

// NG：行・列指定のつもりでA1文字列を渡している
const r = sheet.getRange('2', '3'); // Invalid argument
// OK：どちらかに統一
sheet.getRange('B2');                // A1表記
sheet.getRange(2, 2);                // 行・列（1始まり）

// NG：1次元配列
sheet.getRange(1,1,3,1).setValues(['a','b','c']); // Invalid argument
// OK：2次元に
sheet.getRange(1,1,3,1).setValues([['a'],['b'],['c']]);

// NG：サイズ不一致（範囲3x2に2x2）
sheet.getRange(1,1,3,2).setValues([['a','b'],['c','d']]); // Invalid argument
// OK：範囲と同じ3x2で渡す
sheet.getRange(1,1,3,2).setValues([['a','b'],['c','d'],['e','f']]);

// NG：formatDateの第1引数はDate型
Utilities.formatDate("2025-10-20", "Asia/Tokyo", "yyyy-MM-dd"); // Invalid argument
// OK
const d = new Date("2025-10-20T00:00:00+09:00");
Utilities.formatDate(d, "Asia/Tokyo", "yyyy-MM-dd");

// NG：第2引数に文字列
UrlFetchApp.fetch('https://example.com', 'GET'); // Invalid argument
// OK：オプションはオブジェクト
UrlFetchApp.fetch('https://example.com', { method: 'get', muteHttpExceptions: true });

// NG：fetchAllは「リクエストオブジェクト配列」
UrlFetchApp.fetchAll(['https://a','https://b']); // Invalid argument
// OK
UrlFetchApp.fetchAll([{url:'https://a'},{url:'https://b'}]);

// 代表的OKパターン（シンプル版）
MailApp.sendEmail('user@example.com', '件名', '本文');

// オプション版（オブジェクトで渡す）
MailApp.sendEmail({
  to: 'user@example.com',
  subject: '件名',
  htmlBody: '<b>本文</b>',
  cc: 'cc@example.com'
});

// NG：件名にオブジェクト、本文に数値など
MailApp.sendEmail('user@example.com', {sub:'件名'}, 123); // Invalid argument

// NG：parseは“文字列”を期待
const obj = {a:1};
JSON.parse(obj); // Invalid argument
// OK
JSON.parse('{"a":1}');

// NG：stringifyはオブジェクト/配列を期待（循環参照に注意）
const circular = {}; circular.me = circular;
JSON.stringify(circular); // これは別の例外（循環参照）

// NG：期限が600秒超
CacheService.getScriptCache().put('k', 'v', 1200); // Invalid argument
// OK：1〜600秒
CacheService.getScriptCache().put('k', 'v', 300);

// NG：キー/値にオブジェクト
CacheService.getScriptCache().put('k', {a:1}, 60); // Invalid argument
// OK：文字列化
CacheService.getScriptCache().put('k', JSON.stringify({a:1}), 60);

// NG：存在しない関数名
ScriptApp.newTrigger('notExists').timeBased().everyMinutes(5).create(); // Invalid argument
// OK：実在する関数を指定
function job(){ /*...*/ }
ScriptApp.newTrigger('job').timeBased().everyMinutes(5).create();

// NG：スプレッドシート対象を未指定のままonEdit
ScriptApp.newTrigger('job').onEdit().create(); // Invalid argument
// OK：対象を明示
ScriptApp.newTrigger('job').forSpreadsheet(SpreadsheetApp.getActive()).onEdit().create();

// NG：Values.updateのbodyは {values: 2次元配列}
Sheets.Spreadsheets.Values.update({ value: 'x' }, SHEET_ID, 'A1',
  { valueInputOption: 'RAW' }); // Invalid argument
// OK
Sheets.Spreadsheets.Values.update({ values: [['x']] }, SHEET_ID, 'A1',
  { valueInputOption: 'RAW' });

// NG：Array.mapに関数以外
[1,2,3].map('x'); // Invalid argument
// OK
[1,2,3].map(n => n*2);

const V = {
  is2D: (a) => Array.isArray(a) && a.every(r => Array.isArray(r)),
  req: (cond, msg) => { if (!cond) throw new Error(msg); }
};

function safeSetValues(range, values) {
  V.req(V.is2D(values), '2次元配列が必要です');
  V.req(values.length > 0 && values[0].length > 0, '空配列は不可');
  const r = range.getNumRows(), c = range.getNumColumns();
  V.req(values.length === r && values[0].length === c, '範囲とサイズが一致しません');
  range.setValues(values);
}