GASのLanguageAppで文章を
無料で自動翻訳する方法

function basicTranslate() {
  // LanguageApp.translate(原文, 翻訳元の言語, 翻訳先の言語)
  const en = LanguageApp.translate("こんにちは、お世話になっております。", "ja", "en");
  Logger.log(en); // Hello, thank you for your continued support.

  const ja = LanguageApp.translate("Please find the attached invoice.", "en", "ja");
  Logger.log(ja); // 添付の請求書をご確認ください。
}

function autoDetectTranslate() {
  // 翻訳元に空文字 "" を渡すと言語を自動判定する
  const inputs = [
    "Bonjour tout le monde",   // フランス語
    "Guten Tag",               // ドイツ語
    "안녕하세요",               // 韓国語
  ];

  inputs.forEach((text) => {
    const ja = LanguageApp.translate(text, "", "ja");
    Logger.log(text + " -> " + ja);
  });
}

// A列の原文（日本語）を翻訳し、B列に英訳を書き込む
function translateColumn() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("翻訳");
  const lastRow = sheet.getLastRow();
  if (lastRow < 2) return;

  // 1行目はヘッダー。A2 から最終行までを一括取得
  const sources = sheet.getRange(2, 1, lastRow - 1, 1).getValues();
  const existing = sheet.getRange(2, 2, lastRow - 1, 1).getValues();

  const results = sources.map((row, i) => {
    const text = String(row[0]).trim();
    // 原文が空、またはすでに訳済みならスキップ（上限の節約）
    if (!text || existing[i][0]) return [existing[i][0]];
    const translated = LanguageApp.translate(text, "ja", "en");
    return [translated];
  });

  // まとめて書き戻す（1セルずつ書くより高速）
  sheet.getRange(2, 2, results.length, 1).setValues(results);
}

// 1つの原文を複数の言語へ一括翻訳し、横方向に並べる
function translateToMultipleLanguages() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("多言語");
  const targets = ["en", "zh", "ko"]; // B:英語 C:中国語 D:韓国語
  const lastRow = sheet.getLastRow();
  if (lastRow < 2) return;

  const sources = sheet.getRange(2, 1, lastRow - 1, 1).getValues();

  const results = sources.map((row) => {
    const text = String(row[0]).trim();
    if (!text) return targets.map(() => "");
    return targets.map((lang) => LanguageApp.translate(text, "ja", lang));
  });

  sheet.getRange(2, 2, results.length, targets.length).setValues(results);
}

function translateHtmlMail() {
  const html =
    '<p>Dear <strong>customer</strong>,</p>' +
    '<p>Your order has shipped. <a href="https://example.com">Track it here</a>.</p>';

  // contentType: "html" でタグ構造を保ったまま中身だけ翻訳
  const translated = LanguageApp.translate(html, "en", "ja", {
    contentType: "html",
  });

  Logger.log(translated);
  // <a> や <strong> のタグはそのまま、テキスト部分だけ日本語になる
}

// 同じ原文の再翻訳を避けて、1日の上限を節約する
function translateWithCache(text, source, target) {
  const cache = CacheService.getScriptCache();
  const key = [source, target, text].join("|");

  const cached = cache.get(key);
  if (cached !== null) return cached; // 既訳があればAPIを呼ばない

  const translated = LanguageApp.translate(text, source, target);
  cache.put(key, translated, 21600); // 6時間（最大値）保存
  return translated;
}

function useCachedTranslate() {
  Logger.log(translateWithCache("ありがとうございます", "ja", "en"));
  Logger.log(translateWithCache("ありがとうございます", "ja", "en")); // 2回目はキャッシュから
}