GASでGmailの受信メールを
AIで自動ラベル分類する方法

// スクリプトプロパティにAPIキーを保存（初回1回だけ実行）
function saveApiKey() {
  PropertiesService.getScriptProperties()
    .setProperty("CLAUDE_API_KEY", "sk-ant-xxxxxxxx");
}

function getApiKey() {
  const key = PropertiesService.getScriptProperties().getProperty("CLAUDE_API_KEY");
  if (!key) throw new Error("APIキーが未設定です。saveApiKey を実行してください。");
  return key;
}

// 分類したいラベルの候補（自社の運用に合わせて書き換える）
const LABELS = ["見積依頼", "サポート", "営業", "請求", "その他"];

// 処理済みの目印に使う管理用ラベル
const DONE_LABEL = "AI分類済み";
// 確信度が低いメールに付ける確認用ラベル
const REVIEW_LABEL = "要確認";
// 確信度がこの値未満なら「要確認」を付ける（0〜100）
const CONFIDENCE_THRESHOLD = 60;

// ラベルが無ければ作り、あれば取得する
function getOrCreateLabel(name) {
  return GmailApp.getUserLabelByName(name) || GmailApp.createLabel(name);
}

// 1スレッドの本文から、ラベルと確信度をJSONで受け取る
function classifyMail(subject, body) {
  const choices = LABELS.map(function (l) { return '"' + l + '"'; }).join(", ");

  const instruction =
    "あなたは企業のメール仕分け担当です。\n" +
    "次のメールを、決められたラベルのどれか1つに分類してください。\n" +
    "件名: " + subject + "\n" +
    "本文: " + body + "\n" +
    "使えるラベル: [" + choices + "]\n" +
    "条件:\n" +
    "・必ず上の一覧にあるラベルの中から1つだけ選ぶ。\n" +
    "・判断に迷う・当てはまらない場合は「その他」にする。\n" +
    "・確信度は0〜100の整数で、確からしさを表す。\n" +
    "余計な説明は出力せず、JSONだけを返してください。\n" +
    '形式: {"label": "ラベル名", "confidence": 数値}';

  const payload = {
    model: "claude-sonnet-4-20250514",
    max_tokens: 200,
    messages: [{ role: "user", content: instruction }],
  };

  const res = UrlFetchApp.fetch("https://api.anthropic.com/v1/messages", {
    method: "post",
    contentType: "application/json",
    headers: {
      "x-api-key": getApiKey(),
      "anthropic-version": "2023-06-01",
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true,
  });

  if (res.getResponseCode() !== 200) {
    throw new Error("API error: " + res.getContentText());
  }

  const responseText = JSON.parse(res.getContentText()).content[0].text;
  const result = JSON.parse(extractJson(responseText));

  // 一覧に無いラベルが返ってきたら「その他」に寄せる
  if (LABELS.indexOf(result.label) === -1) result.label = "その他";
  return result; // { label, confidence }
}

// レスポンスから { ... } の部分だけを取り出す（前後の余計な文字対策）
function extractJson(text) {
  const start = text.indexOf("{");
  const end = text.lastIndexOf("}");
  return text.slice(start, end + 1);
}

// スレッドの最新メールから、AIに渡す本文を取り出す
function getLatestBody(thread) {
  const messages = thread.getMessages();
  const last = messages[messages.length - 1]; // 最新のメール
  // 本文が長すぎるとトークンを消費するため先頭2000文字に絞る
  const body = last.getPlainBody().slice(0, 2000);
  return { subject: last.getSubject(), body: body };
}

// 未処理スレッドを検索し、ラベルを付ける
function labelInbox() {
  const doneLabel = getOrCreateLabel(DONE_LABEL);
  const reviewLabel = getOrCreateLabel(REVIEW_LABEL);
  // 受信トレイのうち、まだAI分類していないスレッドだけを取得
  const query = "in:inbox -label:" + DONE_LABEL;
  const threads = GmailApp.search(query, 0, 15); // 1回最大15スレッド

  threads.forEach(function (thread) {
    const mail = getLatestBody(thread);

    let result;
    try {
      result = classifyWithRetry(mail.subject, mail.body);
    } catch (e) {
      Logger.log("分類に失敗: " + e.message);
      return; // このスレッドは飛ばして次へ（完了印は付けない）
    }

    // 判定されたラベルをスレッドに付ける
    getOrCreateLabel(result.label).addToThread(thread);
    // 確信度が低ければ「要確認」も付ける
    if (Number(result.confidence) < CONFIDENCE_THRESHOLD) {
      reviewLabel.addToThread(thread);
    }
    // 処理済みの目印を付ける（次回の検索から外れる）
    doneLabel.addToThread(thread);

    Utilities.sleep(500); // 連続呼び出しの間隔を少し空ける
  });

  Logger.log(threads.length + "スレッドを分類しました。");
}

// 一時的なAPIエラー時に最大3回まで再試行する
function classifyWithRetry(subject, body, maxRetry) {
  const limit = maxRetry || 3;
  for (let attempt = 1; attempt <= limit; attempt++) {
    try {
      return classifyMail(subject, body);
    } catch (e) {
      Logger.log("試行" + attempt + "回目で失敗: " + e.message);
      if (attempt === limit) throw e; // 最後まで失敗したら呼び出し元へ返す
      Utilities.sleep(1000 * attempt); // 待ち時間を伸ばして再試行
    }
  }
}

// 10分おきに自動でラベルを付ける時間主導トリガーを登録する
function setupTrigger() {
  // 二重登録を防ぐため、同名の既存トリガーを消してから作る
  ScriptApp.getProjectTriggers().forEach(function (t) {
    if (t.getHandlerFunction() === "labelInbox") {
      ScriptApp.deleteTrigger(t);
    }
  });
  ScriptApp.newTrigger("labelInbox")
    .timeBased()
    .everyMinutes(10)
    .create();
}