GAS×Gmail×Googleドライブ · 登録不要 · コード全文

Gmailの添付ファイルを、
ドライブに自動保存する（GAS）。

取引先から届く請求書・見積書・注文書のPDFを、毎回ダウンロードしてフォルダに入れ直していませんか。このページでは Google Apps Script（GAS）で、Gmailの添付ファイルを指定のGoogleドライブのフォルダへ日付つきで自動保存し、保存した記録をシートに残す方法を、よくある失敗（二重保存・取りこぼし・途中で止まる）の対策込みで紹介します。

1. できること

2. 準備

1. 保存先にしたいGoogleドライブのフォルダを開き、URLの folders/ の後ろの文字列（フォルダID）をコピーします。
2. 新しいスプレッドシートを作り、「拡張機能 → Apps Script」を開いて下のコードを貼り付け、FOLDER_ID を書き換えます。
3. ▶ で saveAttachments を一度実行し、Gmail・ドライブ・シートの許可を与えます。フォルダにファイルが入り「保存ログ」シートができれば成功です。
4. 左の時計アイコン「トリガー」→「トリガーを追加」→ 関数 saveAttachments・「時間主導型」・「1時間おき」などで保存します。

3. コード全文（コピペで動きます）

const QUERY = 'has:attachment newer_than:3d -in:chats'; // 例: 'from:(billing@example.com) has:attachment newer_than:3d'
const FOLDER_ID = 'ここに保存先フォルダのID';
const EXT_OK = ['pdf', 'xlsx', 'xls', 'csv', 'docx', 'doc', 'zip', 'jpg', 'jpeg', 'png'];
const MIN_BYTES = 5 * 1024;          // 署名画像などの小さいファイルは保存しない
const LOG_SHEET = '保存ログ';
const LIMIT_MS = 4.5 * 60 * 1000;    // 6分の実行上限の手前で止める

function saveAttachments() {
  const start = Date.now();
  const lock = LockService.getScriptLock();
  if (!lock.tryLock(10 * 1000)) return;
  try {
    const log = logSheet_();
    const done = new Set(log.getLastRow() > 1
      ? log.getRange(2, 1, log.getLastRow() - 1, 1).getValues().map(r => String(r[0]))
      : []);
    const folder = DriveApp.getFolderById(FOLDER_ID);
    const threads = GmailApp.search(QUERY, 0, 50);
    for (const th of threads) {
      for (const msg of th.getMessages()) {
        if (Date.now() - start > LIMIT_MS) return; // 残りは次回の実行で
        const id = msg.getId();
        if (done.has(id)) continue;             // 返信がついたスレッドでも新着分だけ処理
        const day = Utilities.formatDate(msg.getDate(), 'Asia/Tokyo', 'yyyyMMdd');
        const from = msg.getFrom().replace(/.*<|>.*/g, '').trim();
        const saved = [];
        for (const att of msg.getAttachments({ includeInlineImages: false })) {
          const name = att.getName() || 'noname';
          const ext = (name.split('.').pop() || '').toLowerCase();
          if (!EXT_OK.includes(ext) || att.getSize() < MIN_BYTES) continue;
          const safe = (day + '_' + name).replace(/[\\/:*?"<>|]/g, '_').slice(0, 150);
          const file = folder.createFile(att.copyBlob().setName(safe));
          saved.push(file.getUrl());
        }
        log.appendRow([id, day, from, msg.getSubject().slice(0, 100),
          saved.length, saved.join('\n')]);
        done.add(id);
      }
    }
  } finally {
    lock.releaseLock();
  }
}

function logSheet_() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  let sh = ss.getSheetByName(LOG_SHEET);
  if (!sh) {
    sh = ss.insertSheet(LOG_SHEET);
    sh.appendRow(['メールID', '受信日', '送信元', '件名', '保存数', '保存先']);
    sh.setFrozenRows(1);
  }
  return sh;
}

書き換えるのは主に QUERY（どのメールを対象にするか）と FOLDER_ID の2つです。検索式はGmailの検索窓と同じ書き方なので、先にGmailで検索して、狙ったメールだけが出ることを確かめてから貼るのが確実です。

4. このコードが防いでいる4つの失敗

• 同じファイルが何個も保存される：保存したメールのIDを「保存ログ」シートに記録し、次回からはスキップします。トリガーが重なっても LockService で同時実行を防ぎます。
• 返信がついたスレッドの新しい添付を取りこぼす：よくある「保存済みラベルを付けて -label:保存済 で除外する」方法は、ラベルがスレッド単位なので、同じスレッドに後から届いた添付を見落とします。このコードはメール1通ごとのIDで判定するため、取りこぼしません。
• 署名のロゴ画像まで保存されてフォルダが散らかる：本文埋め込み画像を除外し、拡張子と最小サイズでも絞っています。
• 件数が多い日に途中で止まる：GASの1回の実行は6分までです。4.5分で自分から止め、残りは次の実行で続きから処理します（処理済みはログで判定するので重複しません）。

5. よくあるつまずき

6. AIはどこに使う？

保存そのものにAIは不要です。便利なのはその次の段階で、保存した請求書の件名・送信元から「取引先・金額・支払期日」を一覧にまとめる、届いた問い合わせに返信の下書きを作る、といった使い方です。AIに渡すのは必要な部分だけにし、金額や期日は必ず人が原本で確認してください。問い合わせメールの下書きは Gmailの問い合わせ返信をAIで下書き、こちらから送る請求書は 請求書PDFとAI添え状メールを自動で下書き にまとめています。

Gmailの受信メールをスプレッドシートに書き出す · Gmail問い合わせ返信をAIで下書き · 請求書PDFとAI添え状メールを自動で下書き · スプレッドシートから差し込みメールを下書き作成 · Googleフォームの自動返信メール · Zenn記事版 · 無料本：GAS×ChatGPT事務自動化の基本

AI Revenue Experiment の用途解説ページです。導入実績や効果測定の結果ではありません。