=GEMINI() を420行に貼って気づいたこと — カスタム関数をやめ、値で書き戻すまでの実測

/**
 * レビュー本文のレンジを受け取り、要約を1列で返します。
 * 呼び出し回数はセル数ではなく1回になります。
 *
 * @param {Array<Array<string>>} range 要約するレビュー本文のレンジ。
 * @return {Array<Array<string>>} 要約テキストの1列。
 * @customfunction
 */
function GEMINI_SUMMARY_RANGE(range) {
  const rows = (Array.isArray(range) ? range : [[range]])
    .map((row) => String(row[0] || '').trim());
 
  // 30秒の予算を先に確保する。超えそうなら残りは印を返して諦める。
  const deadline = Date.now() + 25 * 1000;
  const out = [];
 
  for (const text of rows) {
    if (!text) { out.push(['']); continue; }
    if (Date.now() > deadline) { out.push(['#BUDGET']); continue; }
    out.push([summarizeOne_(text)]);
  }
  return out;
}
 
function summarizeOne_(text) {
  const key = PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY');
  const url = 'https://generativelanguage.googleapis.com/v1beta/models/'
    + 'gemini-flash-latest:generateContent?key=' + key;
  const res = UrlFetchApp.fetch(url, {
    method: 'post',
    contentType: 'application/json',
    payload: JSON.stringify({
      contents: [{ parts: [{ text: '次のレビューを1文で要約してください。\n\n' + text }] }],
      generationConfig: { maxOutputTokens: 120 },
    }),
    muteHttpExceptions: true,
  });
  if (res.getResponseCode() !== 200) return '#GEMINI_ERROR';
  return JSON.parse(res.getContentText()).candidates[0].content.parts[0].text.trim();
}

const SHEET_NAME = 'reviews';
const COL = { text: 3, summary: 4, status: 5, model: 6, at: 7 };
 
function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu('Gemini')
    .addItem('未処理行を要約する', 'runSummaryBatch')
    .addToUi();
}
 
/**
 * 未処理行だけを要約し、値として書き戻します。
 * 途中で6分に達しても、書き戻した分は残ります。再実行すれば続きから進みます。
 */
function runSummaryBatch() {
  const sheet = SpreadsheetApp.getActive().getSheetByName(SHEET_NAME);
  const last = sheet.getLastRow();
  if (last < 2) return;
 
  const values = sheet.getRange(2, 1, last - 1, COL.at).getValues();
  const deadline = Date.now() + 5 * 60 * 1000; // 6分上限の内側で自分から降りる
  let done = 0;
 
  for (let i = 0; i < values.length; i++) {
    if (Date.now() > deadline) break;
 
    const row = i + 2;
    const text = String(values[i][COL.text - 1] || '').trim();
    const status = String(values[i][COL.status - 1] || '').trim();
 
    if (!text) continue;
    if (status === 'ok') continue; // 冪等性はここだけで担保されます
 
    const result = summarizeWithRetry_(text);
 
    // 1行ずつ書き戻す。途中で落ちても、ここまでは確定しています。
    sheet.getRange(row, COL.summary, 1, 4).setValues([[
      result.ok ? result.text : '',
      result.ok ? 'ok' : 'error:' + result.reason,
      'gemini-flash-latest',
      new Date(),
    ]]);
    done++;
  }
 
  SpreadsheetApp.getActive().toast(done + ' 行を処理しました', 'Gemini', 5);
}
 
function summarizeWithRetry_(text) {
  const key = PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY');
  const url = 'https://generativelanguage.googleapis.com/v1beta/models/'
    + 'gemini-flash-latest:generateContent?key=' + key;
  const payload = JSON.stringify({
    contents: [{ parts: [{ text: '次のレビューを1文で要約してください。\n\n' + text }] }],
    generationConfig: { maxOutputTokens: 120 },
  });
 
  for (let attempt = 0; attempt < 4; attempt++) {
    const res = UrlFetchApp.fetch(url, {
      method: 'post',
      contentType: 'application/json',
      payload: payload,
      muteHttpExceptions: true,
    });
    const code = res.getResponseCode();
 
    if (code === 200) {
      const parts = JSON.parse(res.getContentText()).candidates?.[0]?.content?.parts;
      if (!parts || !parts[0]?.text) return { ok: false, reason: 'empty' };
      return { ok: true, text: parts[0].text.trim() };
    }
    // 429 / 5xx だけ待って再挑戦する。400 系を再送しても結果は変わりません。
    if (code !== 429 && code < 500) return { ok: false, reason: 'http' + code };
    Utilities.sleep(Math.pow(2, attempt) * 1000);
  }
  return { ok: false, reason: 'retry_exhausted' };
}