用 Gemini 自動翻譯 Google 文件內容

Overview這篇教學會幫你做出什麼

很多團隊都有一份「中文母版」文件，需要另外生出英文、日文版本。以前是複製一份、貼進翻譯網站、再一段一段貼回來，既慢又容易漏段。這篇教學要教你把 Gemini 直接裝進 Google 文件裡，開一份文件、按一下選單，就能把整份內容翻成你要的語言。

你不需要會寫程式，只要跟著步驟一格一格貼上程式碼即可。看完之後，你會擁有一個屬於自己、可以重複使用的文件翻譯工具，之後任何文件都能沿用。

Why為什麼用 GAS＋Gemini 而不是手動翻譯

手動翻譯最大的問題不是「翻得慢」，而是「格式亂」。你把文字丟到翻譯網站，貼回來之後標題、清單、段落全都黏成一團，還得花時間重排。用 DocumentApp 是以「段落」為單位讀寫，翻譯完直接對應回原本的位置，版面幾乎不用重整。

另一個好處是它住在 Google 文件裡。工具就在你每天工作的地方，不必切換視窗、不必複製貼上，同事打開同一份文件也能用同一個選單。加上 Gemini 對上下文的理解比傳統逐字翻譯更自然，專有名詞、語氣都能在提示詞裡交代清楚，品質更貼近真人。

Prepare動手前要準備的東西

Steps一步一步做出來

下面第一段程式碼是「打電話給 Gemini」的共用函式，之後每一篇教學都會用到它，直接照抄不用改。

function askGemini(prompt) {
  const key = PropertiesService.getScriptProperties().getProperty('GEMINI_API_KEY');
  const url = 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=' + key;
  const payload = { contents: [{ parts: [{ text: prompt }] }] };
  const res = UrlFetchApp.fetch(url, { method:'post', contentType:'application/json', payload: JSON.stringify(payload), muteHttpExceptions:true });
  return JSON.parse(res.getContentText()).candidates[0].content.parts[0].text.trim();
}

第二段是主流程：建立選單、逐段讀出文件、翻譯後回填。想換語言只要改最上面的 TARGET_LANG。

const TARGET_LANG = '英文'; // 想翻日文就改成 '日文'

function onOpen() {
  DocumentApp.getUi()
    .createMenu('AI 翻譯')
    .addItem('翻譯整份文件', 'translateDoc')
    .addToUi();
}

function translateDoc() {
  const body = DocumentApp.getActiveDocument().getBody();
  const paras = body.getParagraphs();
  for (let i = 0; i < paras.length; i++) {
    const text = paras[i].getText().trim();
    if (!text) continue; // 跳過空段落
    const prompt = '請把以下內容翻譯成' + TARGET_LANG +
      '，只回傳翻譯結果，不要加任何說明或引號：\n\n' + text;
    const translated = askGemini(prompt);
    // 在原段落後面插入一段翻譯
    const idx = body.getChildIndex(paras[i]);
    body.insertParagraph(idx + 1, translated)
        .setForegroundColor('#1a73e8');
  }
  DocumentApp.getUi().alert('翻譯完成！翻譯內容已加在每段原文下方。');
}

存檔、重新整理文件、從選單執行，你就會看到藍色的翻譯文字出現在每段原文下方。如果你希望「另存成新文件」而不是附在原文下，可以把翻譯結果先收集成陣列，最後用 DocumentApp.create() 建立新文件再寫入。

Flow整個流程長這樣

看懂這個流程後，你會發現其他 AI 自動化幾乎都是同一套骨架：讀資料 → 組提示詞 → 呼叫 Gemini → 寫回結果。換個服務、換個提示詞，就能變出各種工具。

Tips實用小技巧

• 文件很長時，逐段呼叫可能超時。可改成「先選取要翻的段落再執行」，或分批處理避免超過 6 分鐘限制。
• 在提示詞裡補一句「保留專有名詞不翻譯，例如 Fulldot」，能避免品牌名被亂翻。
• 想要多語言，可把 TARGET_LANG 改成陣列，用迴圈一次產出英文、日文兩版。
• 把翻譯字設成不同顏色（例如藍色），校稿時一眼就能分辨原文與譯文。
• gemini-2.5-flash 速度快又便宜，適合大量文字；若要更講究語氣，可換成 pro 版模型。

FAQ常見問題

CTA下一步｜把重複工作交給流程

做完這個翻譯工具，你已經掌握「讀資料 → 呼叫 Gemini → 寫回結果」的核心套路。接下來只要換服務、換提示詞，就能把更多重複工作自動化。若想帶著團隊系統化導入，歡迎進一步了解。

本文為賴家榮 AI 教學中心原創教學內容；想讓團隊學會用 AI，歡迎看AI 課程或預約授課 →

代表圖片來源：圖片來源：Pexels