GASでGmailの添付ファイルを
自動でGoogleドライブに保存する方法

function saveAttachmentsBasic() {
  // 保存先フォルダのIDを指定（ドライブのフォルダURL末尾の文字列）
  const FOLDER_ID = "ここに保存先フォルダのIDを貼る";
  const folder = DriveApp.getFolderById(FOLDER_ID);

  // 添付付きの未処理メールを検索（直近7日分に絞る）
  const query = "has:attachment newer_than:7d -label:保存済み";
  const threads = GmailApp.search(query, 0, 20); // 一度に20スレッドまで

  threads.forEach((thread) => {
    thread.getMessages().forEach((message) => {
      // インライン画像（署名画像など）は除外する
      const attachments = message.getAttachments({ includeInlineImages: false });
      attachments.forEach((attachment) => {
        folder.createFile(attachment.copyBlob());
      });
    });
    // 処理済みラベルを付けて二重保存を防ぐ
    thread.addLabel(getOrCreateLabel("保存済み"));
  });
}

// ラベルが無ければ作って返すヘルパー
function getOrCreateLabel(name) {
  return GmailApp.getUserLabelByName(name) || GmailApp.createLabel(name);
}

// 「2026-07」のような月別サブフォルダを取得（無ければ作成）
function getMonthlyFolder(parentId) {
  const parent = DriveApp.getFolderById(parentId);
  const name = Utilities.formatDate(
    new Date(),
    "Asia/Tokyo",
    "yyyy-MM"
  );

  // 同名フォルダの重複作成を防ぐため、まず既存を探す
  const it = parent.getFoldersByName(name);
  if (it.hasNext()) {
    return it.next();
  }
  return parent.createFolder(name);
}

function saveIntoMonthlyFolder() {
  const PARENT_ID = "ここに親フォルダのIDを貼る";
  const folder = getMonthlyFolder(PARENT_ID);

  const threads = GmailApp.search("has:attachment -label:保存済み", 0, 20);
  threads.forEach((thread) => {
    thread.getMessages().forEach((message) => {
      message.getAttachments({ includeInlineImages: false }).forEach((att) => {
        folder.createFile(att.copyBlob());
      });
    });
    thread.addLabel(getOrCreateLabel("保存済み"));
  });
}

// PDFだけを保存する例（拡張子とMIMEタイプの両方で判定）
function savePdfOnly() {
  const FOLDER_ID = "ここに保存先フォルダのIDを貼る";
  const folder = DriveApp.getFolderById(FOLDER_ID);

  // 送信者を絞ると誤保存を防げる
  const query = "has:attachment from:invoice@example.com -label:保存済み";
  const threads = GmailApp.search(query, 0, 20);

  threads.forEach((thread) => {
    thread.getMessages().forEach((message) => {
      message.getAttachments({ includeInlineImages: false }).forEach((att) => {
        const name = att.getName().toLowerCase();
        const isPdf =
          att.getContentType() === "application/pdf" || name.endsWith(".pdf");
        if (!isPdf) return;              // PDF以外はスキップ
        if (att.getSize() < 1024) return; // 1KB未満の小さすぎる添付も除外

        folder.createFile(att.copyBlob());
      });
    });
    thread.addLabel(getOrCreateLabel("保存済み"));
  });
}

// 「日付_送信者_元のファイル名」でリネームして保存する
function saveWithRenamedFiles() {
  const FOLDER_ID = "ここに保存先フォルダのIDを貼る";
  const folder = DriveApp.getFolderById(FOLDER_ID);

  const threads = GmailApp.search("has:attachment -label:保存済み", 0, 20);
  threads.forEach((thread) => {
    thread.getMessages().forEach((message) => {
      const dateStr = Utilities.formatDate(
        message.getDate(),
        "Asia/Tokyo",
        "yyyyMMdd"
      );
      // 送信者のメールアドレス部分だけ取り出す
      const from = (message.getFrom().match(/[\w.+-]+@[\w.-]+/) || ["unknown"])[0];

      message.getAttachments({ includeInlineImages: false }).forEach((att) => {
        const blob = att.copyBlob();
        blob.setName(dateStr + "_" + from + "_" + att.getName());
        folder.createFile(blob);
      });
    });
    thread.addLabel(getOrCreateLabel("保存済み"));
  });
}

// 1時間ごとに実行するトリガーをコードから設定する
function createHourlyTrigger() {
  // 重複作成を防ぐため、既存の同名トリガーを削除してから作る
  ScriptApp.getProjectTriggers().forEach((t) => {
    if (t.getHandlerFunction() === "saveIntoMonthlyFolder") {
      ScriptApp.deleteTrigger(t);
    }
  });

  ScriptApp.newTrigger("saveIntoMonthlyFolder")
    .timeBased()
    .everyHours(1)
    .create();
}