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

function saveEmailAttachmentsToDrive() {
  // ユーザー設定 - ここを変更してください
  var settings = {
    excludedEmailAddresses: ['email@example.com', 'another_email@example.com'], // 処理対象外のメールアドレス
    folderId: 'xxxxxxxxxxxxxxxxxxxxxx', // 添付ファイルを保存するGoogleドライブフォルダのID
    maxThreads: 30, // 一度に処理するスレッド数
    waitTime: 3000, // ファイル保存後の待機時間（ミリ秒）
    retryCount: 3 // 保存失敗時の再試行回数
  };

  var startTime = new Date(); // 処理開始時間の記録

  // フォルダ、ログファイル、処理済み添付ファイルID、処理済みスレッドIDの取得
  var folder = DriveApp.getFolderById(settings.folderId); // 保存先のGoogleドライブフォルダを取得
  var logFile = getLogFile(); // ログファイルを取得または作成
  var processedAttachments = getProcessedSet('processedAttachments'); // 既に処理された添付ファイルIDを取得
  var processedThreads = getProcessedSet('processedThreads'); // 既に処理されたスレッドIDを取得
  var start = getStartIndex(); // 前回の実行位置を取得

  try {
    var threads = GmailApp.getInboxThreads(start, settings.maxThreads); // 指定された数のスレッドを取得
    if (threads.length === 0) { // スレッドが存在しない場合の処理
      logMessage(logFile, "全ての添付ファイルを保存しました。");
      PropertiesService.getScriptProperties().deleteProperty('start'); // 全スレッドを処理済みの場合、開始位置をリセット
      return;
    }

    threads.forEach(thread => {
      if (!processedThreads.has(thread.getId())) { // まだ処理していないスレッドか確認
        processThread(thread, settings, folder, processedAttachments, logFile); // スレッド内のメッセージを処理
        processedThreads.add(thread.getId()); // 処理済みスレッドIDを記録
      }
    });

    PropertiesService.getScriptProperties().setProperty('start', (start + settings.maxThreads).toString()); // 次回の開始位置を更新
    saveProcessedSet('processedAttachments', processedAttachments); // 処理済み添付ファイルIDを保存
    saveProcessedSet('processedThreads', processedThreads); // 処理済みスレッドIDを保存
    logMessage(logFile, "スレッドの一部を処理しました。次回実行時に続きます。");

  } catch (e) {
    logError(logFile, "スレッドの処理中にエラーが発生しました: " + e.toString()); // エラーログを記録
  } finally {
    var endTime = new Date(); // 処理終了時間の記録
    var duration = (endTime - startTime) / 1000; // 処理時間を秒単位で計算
    logMessage(logFile, `処理時間: ${duration} 秒`); // 処理時間をログに記録
  }
}

// スレッド内のメッセージと添付ファイルを処理する関数
function processThread(thread, settings, folder, processedAttachments, logFile) {
  thread.getMessages().forEach(message => { // スレッド内の各メッセージを処理
    var sender = message.getFrom() || "noname"; // 送信者のメールアドレスを取得、存在しない場合は"noname"
    if (settings.excludedEmailAddresses.some(email => sender.includes(email))) return; // 対象外メールアドレスの場合スキップ

    var formattedDateTime = formatDateTime(message.getDate()); // メッセージの受信日時をフォーマット
    message.getAttachments().forEach((attachment, index) => { // メッセージ内の各添付ファイルを処理
      processAttachment(message, attachment, index, sender, formattedDateTime, folder, processedAttachments, logFile, settings.waitTime, settings.retryCount);
    });
  });
}

// 添付ファイルを処理し、フォルダに保存する関数
function processAttachment(message, attachment, index, sender, formattedDateTime, folder, processedAttachments, logFile, waitTime, retryCount) {
  var attachmentId = generateAttachmentId(message, attachment, index); // 添付ファイルIDを生成
  if (processedAttachments.has(attachmentId)) return; // 既に処理済みの添付ファイルはスキップ

  var uniqueFileName = getUniqueFileName(folder, cleanFileName(`${sender}_${formattedDateTime}_${attachment.getName()}`), message.getId(), index); // 一意のファイル名を生成
  var saved = false; // 保存フラグの初期化

  for (var attempt = 0; attempt < retryCount; attempt++) { // 再試行回数分ループ
    try {
      var attachmentFile = folder.createFile(attachment.copyBlob()); // 添付ファイルをフォルダに保存
      attachmentFile.setName(uniqueFileName); // ファイル名を設定
      processedAttachments.add(attachmentId); // 添付ファイルIDを記録
      saved = true; // 保存成功フラグを立てる
      break; // 保存に成功したらループを抜ける
    } catch (e) {
      logError(logFile, `ファイルの保存に失敗しました (試行回数: ${attempt + 1}): ${e.toString()}`); // 保存失敗時のエラーログを記録
      Utilities.sleep(waitTime); // 保存失敗時に待機時間を設定
    }
  }

  if (!saved) {
    logError(logFile, "ファイルの保存に最終的に失敗しました: " + uniqueFileName); // 保存が最終的に失敗した場合のエラーログを記録
  }
}

// 添付ファイルIDを生成する関数（メッセージIDと添付ファイルのハッシュ値を使用）
function generateAttachmentId(message, attachment, index) {
  // 添付ファイルの内容をMD5ハッシュ化して一意のIDを生成
  var hash = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, attachment.getBytes()).map(byte => {
    var v = (byte < 0 ? byte + 256 : byte).toString(16); // バイト値を16進数に変換
    return v.length == 1 ? "0" + v : v; // 1桁の値は2桁に揃える
  }).join("");
  return `${message.getId()}_${hash}`; // メッセージIDとハッシュ値を組み合わせて一意のIDを生成
}

// 日付と時間をフォーマットする関数
function formatDateTime(date) {
  // 年月日_時分の形式にフォーマット
  return `${date.getFullYear().toString().slice(-2)}${String(date.getMonth() + 1).padStart(2, '0')}${String(date.getDate()).padStart(2, '0')}_${String(date.getHours()).padStart(2, '0')}${String(date.getMinutes()).padStart(2, '0')}`;
}

// ファイル名をクリーンアップする関数
function cleanFileName(fileName) {
  // ファイル名に使用できない文字を削除
  return fileName.replace(/[\\/:*?"<>|]/g, '');
}

// 一意のファイル名を生成する関数
function getUniqueFileName(folder, baseFileName, messageId, index) {
  var extension = baseFileName.slice(baseFileName.lastIndexOf('.')); // ファイルの拡張子を取得
  var baseName = baseFileName.slice(0, baseFileName.lastIndexOf('.')); // ファイル名のベース部分を取得
  var uniqueFileName = `${baseName}_${messageId}_${index}${extension}`; // 一意のファイル名を生成

  if (!folder.getFilesByName(uniqueFileName).hasNext()) return uniqueFileName; // ファイル名が重複していない場合そのまま返す
  return `${baseName}_${new Date().getTime()}_${messageId}_${index}${extension}`; // ファイル名が重複する場合タイムスタンプを追加して返す
}

// ログファイルを取得または作成する関数
function getLogFile() {
  var logFileName = 'email_attachment_log.txt'; // ログファイルの名前
  var logFiles = DriveApp.getFilesByName(logFileName); // ログファイルを取得
  return logFiles.hasNext() ? logFiles.next() : DriveApp.createFile(logFileName, ''); // 既存のログファイルがあればそれを使用、なければ新規作成
}

// エラーログを記録する関数
function logMessage(logFile, message) {
  var logContent = logFile.getBlob().getDataAsString(); // ログファイルの内容を取得
  logFile.setContent(logContent + `${new Date().toLocaleString()} - ${message}\n`); // 新しいログメッセージを追加して保存
}

// エラーログを記録する関数
function logError(logFile, message) {
  logMessage(logFile, `ERROR: ${message}`); // エラーログを記録
}

// 処理済みIDセットを取得する関数
function getProcessedSet(property) {
  var processedSet = PropertiesService.getUserProperties().getProperty(property); // プロパティから処理済みIDセットを取得
  return processedSet ? new Set(JSON.parse(processedSet)) : new Set(); // JSONからセットに変換して返す
}

// 処理済みIDセットを保存する関数
function saveProcessedSet(property, processedSet) {
  PropertiesService.getUserProperties().setProperty(property, JSON.stringify(Array.from(processedSet))); // セットをJSONに変換して保存
}

// 開始位置を取得する関数
function getStartIndex() {
  var start = PropertiesService.getScriptProperties().getProperty('start'); // 前回の実行位置を取得
  return start ? parseInt(start, 10) : 0; // 数値に変換して返す、存在しない場合は0を返す
}

folderId: 'xxxxxxxxxxxxxx', // 添付ファイルを保存するGoogleドライブフォルダのID

folderId: '1hjnn0L64MM9ZSqKjtW5BDjtP8BaQkeKN', // 添付ファイルを保存するGoogleドライブフォルダのID