GASのログ出力とデバッグの基本
console.logとLoggerの使い分け

function logBasics() {
  const value = 42;

  // 推奨: console.log。複数の値はカンマで並べて渡せる
  console.log('計算結果は', value, 'です');

  // GAS独自の古いロガー。こちらも実行ログに残る
  Logger.log('計算結果は %s です', value);
}

function logLevels() {
  console.log('通常の処理ログ');      // info相当。普段づかい
  console.info('補足情報');           // 補足メッセージ
  console.warn('件数が想定より多い');  // 警告（黄色で強調）
  console.error('APIの呼び出しに失敗'); // エラー（赤色で強調）
}

function logObject() {
  const row = { name: '田中', age: 30, tags: ['GAS', 'AI'] };

  // NG: 文字列と結合すると [object Object] になる
  console.log('data: ' + row);
  // → data: [object Object]

  // OK: カンマで渡すとオブジェクトのまま展開される
  console.log('data:', row);

  // OK: 見やすく整形したい場合は JSON.stringify
  console.log(JSON.stringify(row, null, 2));
  // {
  //   "name": "田中",
  //   "age": 30,
  //   "tags": ["GAS", "AI"]
  // }
}

function importWithLogging() {
  try {
    console.log('処理を開始します');

    const sheet = SpreadsheetApp.getActiveSpreadsheet()
      .getSheetByName('データ');
    const values = sheet.getDataRange().getValues();

    console.log('読み込み件数:', values.length - 1);

    // ... ここで本処理 ...

    console.log('処理が正常に完了しました');
  } catch (e) {
    // スタックトレース付きでエラーを記録する
    console.error('処理に失敗しました:', e.stack);

    // 管理者にメールで通知する（静かな失敗を防ぐ）
    MailApp.sendEmail(
      'admin@example.com',
      '[GAS] バッチ処理でエラー',
      'エラー内容:\n' + e.stack
    );
  }
}

// 専用の「ログ」シートに実行記録を1行ずつ追記する
function writeLog(level, message) {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  let sheet = ss.getSheetByName('ログ');

  // シートが無ければ作ってヘッダーを付ける
  if (!sheet) {
    sheet = ss.insertSheet('ログ');
    sheet.appendRow(['日時', 'レベル', 'メッセージ']);
  }

  const now = Utilities.formatDate(
    new Date(),
    'Asia/Tokyo',
    'yyyy/MM/dd HH:mm:ss'
  );
  sheet.appendRow([now, level, message]);
}

function useWriteLog() {
  writeLog('INFO', 'バッチ処理を開始');
  // ... 処理 ...
  writeLog('INFO', '3件を更新しました');
}

function measureTime() {
  const start = Date.now();

  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
  const values = sheet.getDataRange().getValues(); // 重い可能性のある処理

  const elapsed = Date.now() - start;
  console.log('読み込みにかかった時間:', elapsed, 'ms');

  // V8ランタイムなら console.time / timeEnd も使える
  console.time('集計');
  const total = values.reduce((sum, row) => sum + (Number(row[2]) || 0), 0);
  console.timeEnd('集計'); // → 集計: 12 ms のように出力
  console.log('合計:', total);
}