GAS『Exceeded Maximum Email Recipients per Day』の原因と対処法

// 重複・空文字・形式不正を除去
function sanitizeRecipients(list) {
  const seen = new Set();
  const out = [];
  const re = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
  for (const raw of list.map(s => String(s || '').trim())) {
    if (!raw || !re.test(raw)) continue;
    const key = raw.toLowerCase();
    if (!seen.has(key)) { seen.add(key); out.push(raw); }
  }
  return out;
}

// 設定：1通あたり To の最大宛先数（Cc/Bccを使う場合は調整）
const MAX_PER_MESSAGE = 50;

// 擬似的に“今日の残枠”をプロパティで運用（実際の上限は環境依存）
function getRemainingQuota() {
  const p = PropertiesService.getScriptProperties();
  const today = new Date().toDateString();
  const state = JSON.parse(p.getProperty('mail_quota') || '{}');
  if (state.date !== today) {
    // 日替わりでリセット（実際のリセット時刻は環境依存なので緩く合わせる）
    p.setProperty('mail_quota', JSON.stringify({ date: today, sent: 0 }));
    return Infinity; // 上限不明のため“制御側で上限を決める”運用にする
  }
  // 運用側で“1日の送信上限（推奨値）”を決める
  const DAILY_BUDGET = Number(p.getProperty('DAILY_BUDGET') || 900); // 例：900
  return Math.max(0, DAILY_BUDGET - (state.sent || 0));
}

function addSentCount(n) {
  const p = PropertiesService.getScriptProperties();
  const today = new Date().toDateString();
  const state = JSON.parse(p.getProperty('mail_quota') || '{}');
  const sent = (state.date === today ? (state.sent || 0) : 0) + n;
  p.setProperty('mail_quota', JSON.stringify({ date: today, sent }));
}

function sendBulkEmails() {
  const p = PropertiesService.getScriptProperties();
  const cursor = Number(p.getProperty('cursor') || 0);

  // 送信先リストを取得する（例：シートや外部ソース）
  const all = sanitizeRecipients(loadRecipientsFromSheet());
  const remain = getRemainingQuota();
  if (remain <= 0) { scheduleNextDay(); return; }

  // 今日送れる分だけ切り出し
  const todays = all.slice(cursor, cursor + remain);
  let i = 0;

  while (i < todays.length) {
    const chunk = todays.slice(i, i + MAX_PER_MESSAGE);
    try {
      MailApp.sendEmail({
        to: chunk.join(','),
        subject: 'お知らせ',
        htmlBody: buildHtmlBody(),
        name: '通知システム'
      });
      addSentCount(chunk.length);
    } catch (e) {
      // 一部失敗時はログと継続（連続エラーが多い場合は停止）
      console.error('send failed', { message: e.message, chunk });
      if (/Exceeded|Limit|Rate/i.test(e.message)) {
        // 送信制限系は即終了→翌日に再開
        p.setProperty('cursor', String(cursor + i));
        scheduleNextDay();
        return;
      }
    }
    i += chunk.length;
    Utilities.sleep(500); // 軽いスロットリング
  }

  // 送り切れなかったら翌日へ
  const nextCursor = cursor + todays.length;
  p.setProperty('cursor', String(nextCursor));
  if (nextCursor < all.length) scheduleNextDay();
  else p.deleteProperty('cursor'); // 完了
}

function scheduleNextDay() {
  // 翌日に再開（“時間ベースのトリガー”を作成）
  ScriptApp.newTrigger('sendBulkEmails').timeBased().after(24 * 60 * 60 * 1000).create();
}

function loadRecipientsFromSheet() {
  const ss = SpreadsheetApp.getActive();
  const sh = ss.getSheetByName('Recipients');
  const vals = sh.getRange(2,1, sh.getLastRow()-1, 1).getValues();
  return vals.map(r => r[0]);
}

function buildHtmlBody() {
  return '<p>お知らせ本文</p>';
}

// 実際に送らず、今日送れる人数と翌日に回す人数を見積もる
function dryRun() {
  const p = PropertiesService.getScriptProperties();
  const cursor = Number(p.getProperty('cursor') || 0);
  const all = sanitizeRecipients(loadRecipientsFromSheet());
  const remain = getRemainingQuota();
  const canSend = Math.min(remain, Math.max(0, all.length - cursor));
  console.log({
    total: all.length,
    cursor,
    today_can_send: canSend,
    will_remain: all.length - (cursor + canSend)
  });
}

function alertIfStuck() {
  const p = PropertiesService.getScriptProperties();
  const cursor = p.getProperty('cursor');
  const last = p.getProperty('last_error_time');
  if (last && Date.now() - Number(last) > 6 * 60 * 60 * 1000) {
    MailApp.sendEmail('admin@example.com', '配信キュー停滞', 'cursor=' + cursor);
  }
}