GASでスプレッドシートの文章を
AIで自動翻訳する方法

// 一度だけ実行してAPIキーを安全に保存する
function saveApiKey() {
  // 実行後、この関数のキー文字列は削除しておく
  PropertiesService.getScriptProperties()
    .setProperty("ANTHROPIC_API_KEY", "sk-ant-xxxxxxxx");
}

// コードからはキー名で読み出す（直書きしない）
function getApiKey() {
  const key = PropertiesService.getScriptProperties()
    .getProperty("ANTHROPIC_API_KEY");
  if (!key) throw new Error("APIキーが未設定です。saveApiKeyを実行してください。");
  return key;
}

// テキストを指定言語に翻訳して返す
// targetLang 例: "日本語", "英語", "中国語(簡体字)"
function translateText(text, targetLang) {
  const url = "https://api.anthropic.com/v1/messages";

  const prompt =
    "次の文章を" + targetLang + "に翻訳してください。\n" +
    "・訳文だけを出力し、前置きや注釈は書かない。\n" +
    "・自然で読みやすいビジネス文体にする。\n" +
    "・固有名詞や製品名は無理に訳さない。\n\n" +
    "文章:\n" + text;

  const payload = {
    model: "claude-haiku-4-5",
    max_tokens: 1000,
    messages: [{ role: "user", content: prompt }]
  };

  const options = {
    method: "post",
    contentType: "application/json",
    headers: {
      "x-api-key": getApiKey(),
      "anthropic-version": "2023-06-01"
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true // エラー時も例外にせずレスポンスを受け取る
  };

  const res = UrlFetchApp.fetch(url, options);
  const code = res.getResponseCode();
  if (code !== 200) {
    throw new Error("API エラー (" + code + "): " + res.getContentText());
  }

  return JSON.parse(res.getContentText()).content[0].text.trim();
}

// 一時的なエラー時に少し待って再試行する
function translateWithRetry(text, targetLang, maxRetry) {
  maxRetry = maxRetry || 3;

  for (let i = 0; i < maxRetry; i++) {
    try {
      return translateText(text, targetLang);
    } catch (e) {
      // 最後の試行で失敗したら、そのまま呼び出し元に投げる
      if (i === maxRetry - 1) throw e;
      // 待ち時間を1秒・2秒・4秒と伸ばす（指数バックオフ）
      Utilities.sleep(1000 * Math.pow(2, i));
    }
  }
}

// A列の原文を翻訳してB列に書き込む
// シート構成: A=原文, B=翻訳（空のセルだけ処理する）
function translateColumn() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("翻訳");
  const targetLang = "日本語"; // 翻訳先の言語
  const lastRow = sheet.getLastRow();
  if (lastRow < 2) return; // データなし（1行目はヘッダー想定）

  // A列(原文)とB列(翻訳)をまとめて読み込む
  const rows = sheet.getRange(2, 1, lastRow - 1, 2).getValues();

  let count = 0;
  for (let i = 0; i < rows.length; i++) {
    const source = String(rows[i][0]).trim();
    const done = String(rows[i][1]).trim();

    if (!source) continue;   // 原文が空ならスキップ
    if (done) continue;      // すでに翻訳済みならスキップ

    const translated = translateWithRetry(source, targetLang);

    // B列（i行目の実セル位置）に書き込む
    sheet.getRange(i + 2, 2).setValue(translated);
    SpreadsheetApp.flush(); // 途中経過をすぐ画面に反映する

    count++;
    if (count >= 30) break;  // 1回30件までに区切る（実行時間制限対策）
    Utilities.sleep(300);    // 連続呼び出しの間隔をあける
  }
}

// シートを開いたときに翻訳メニューを追加する
function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu("AI翻訳")
    .addItem("空のセルを翻訳する", "translateColumn")
    .addToUi();
}