GAS×Gemini 新信自動分類貼標籤歸檔

Overview這一課你會做出什麼

你會做出一套自動分類系統：程式定時撈出 Gmail 新進未讀信，把每封交給 Gemini 判斷類別，再用 GmailApp 自動貼上對應標籤歸檔，讓收件匣按主題分門別類，一目了然。

這套流程很適合信件雜、又想維持收件匣整齊的人。你可以設定每小時執行一次，新信一進來就被自動貼上「客戶」「帳單」「電子報」等標籤歸位，日後要找特定主題的信，點標籤就能一次看齊。

Why先看情境：這解決什麼問題

Gmail 雖然有內建篩選器，但它只能靠寄件者、關鍵字這類固定規則分類。真實世界的信件千變萬化：同一個客戶可能今天談報價、明天問技術、後天要開發票，光靠關鍵字很難精準歸類，你還是得常常手動整理，把信一封封拖進正確的標籤。

有了 GAS 加上 Gemini，分類可以交給真正「讀懂內容」的 AI。程式定時撈出新信，把內容交給 Gemini 判斷它屬於哪一類，再自動貼上對應標籤。因為是根據語意判斷，不受限於死板的關鍵字規則，分類更貼近實際內容。你的收件匣會自動維持整齊，要找某主題的信時，點該標籤就能一次看完，省下大量手動歸檔的時間。

Prepare動手前準備

Steps一步一步實作

以下兩段程式碼是核心。第一段 askGemini 為共用 AI 呼叫函式，請原樣照抄；第二段 autoLabelMail 負責撈新信、請 AI 分類並貼標籤。程式用一個「已分類」的母標籤來標記處理過的信，搜尋時排除它，避免重複判斷同一封信浪費 API 配額。

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();
}

function autoLabelMail() {
  // 允許的分類清單，AI 只能從這裡挑
  const categories = ['客戶', '帳單', '電子報', '其他'];
  const doneLabel = getOrCreateLabel('已分類'); // 標記處理過的信

  // 1. 只撈尚未分類的新信，最多 15 封避免超時
  const threads = GmailApp.search('is:unread -label:已分類', 0, 15);

  threads.forEach(function(thread) {
    const msg = thread.getMessages()[0];
    const from = msg.getFrom();
    const subject = msg.getSubject();
    const plain = msg.getPlainBody().slice(0, 1200);

    // 2. 請 Gemini 從固定清單挑一個類別
    const prompt = '請閱讀這封信，只回覆下列其中一個詞，不要多餘說明：' +
      categories.join('、') + '。\n寄件者：' + from + '\n主旨：' + subject + '\n內容：' + plain;
    let cat = askGemini(prompt);
    if (categories.indexOf(cat) === -1) cat = '其他'; // 白名單過濾

    // 3. 建立或取用該類別標籤並貼上，同時貼「已分類」
    const label = getOrCreateLabel('AI/' + cat);
    thread.addLabel(label);
    thread.addLabel(doneLabel);
  });
}

// 依名稱取得標籤，沒有就建立
function getOrCreateLabel(name) {
  return GmailApp.getUserLabelByName(name) || GmailApp.createLabel(name);
}

Flow一張圖看懂流程

用文字描述就是：時間觸發器每小時啟動程式，程式搜尋還沒被貼上「已分類」標籤的未讀新信；接著逐封把寄件者、主旨與內文前段交給 Gemini，請它從固定清單裡挑一個類別；程式用白名單確認回覆合法後，建立或取用對應標籤貼到信上，並同時貼上「已分類」標籤，下次搜尋就會自動跳過這封，不會重複判斷。

Tips常見錯誤與優化

• 用一個「已分類」母標籤標記處理過的信，搜尋時排除它，才不會每次都重複判斷同一批信浪費配額。
• 限定 AI 只能從固定清單挑類別，程式端再用白名單過濾，避免出現預期外的標籤名稱。
• 標籤用巢狀命名（例如 AI/客戶），可在 Gmail 左側自動收合成一組，介面更整齊。
• 一次用 max 限制封數（例如 15 封），避免信量暴增時超過單次執行時間上限。
• 分類要更細時，把類別清單擴充並在提示詞加上每類的簡短定義，AI 判斷會更準。

FAQ常見問題 Q&A

CTA下一步

當新信一進來就被自動貼好標籤歸位，你的收件匣會從此維持整齊，找信也更快。把這招學會後，可以再讓程式針對特定類別自動草擬回信，把「分類」與「回覆」串成一條完整的自動化流水線。

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

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