GAS(Google Apps Script)でフォルダコピー(サブフォルダ含む)をしたいです

Question

実現したいこと

お世話になります。

GASで別共有ドライブ間で指定フォルダのコピーをするスクリプトを作成しようとしています。
ネットの情報やChatGTPのアドバイスを参考に作成を進めてきたのですが、
どうしてもうまくいかない部分があったのでここで質問しようと思います。

前提

下記のようなGASを作成中です。
スプレットシートで指定されたコピー元とコピー先のアイテムID間でサブフォルダも含んだコピー
をします。無料版だと6分、有料版だと30分で処理がタイムアウトしてしまうので、
指定時間でコピー処理を自動終了し、トリガーで再実行された時にコピー処理を再開させるようにしたいです。

スクリプトの説明
1.コピー元のsourceFolderIdとコピー先のtargetFolderIdを指定するとサブフォルダ以下も含めてコピーする。
2.コピー元のsourceFolderIdはActiveSpreadsheetの'フォルダコピー'シートの'B3'セルを読み込んで指定する。
3.コピー先のtargetFolderIdはActiveSpreadsheetの'フォルダコピー'シートの'B6'セルを読み込んで指定する。
4.初回の処理開始日時をActiveSpreadsheetの'フォルダコピー'シートの'E3'セルに設定する。
5.全ての処理が完了したら処理完了日時をActiveSpreadsheetの'フォルダコピー'シートの'E4'セルに設定する。
6.コピー処理中にGASを実行しても処理が実行できないようにLockService.getScriptLock()でロックを掛ける。
7.処理時間が指定時間(デフォルト5分)を経過すると処理を中断してコピーの処理状態をPropertiesService.getScriptProperties().setPropertyで保存してロックを解放して終了する。
8.GASを再実行するとPropertiesService.getScriptProperties().getPropertyで中断していたコピー処理を再開する。
9.実行が初回の場合はコンソールログに"Starting new session."と表示するようにする。
10.実行が2回目以降の場合はコンソールログに"Resuming session."と表示するようにする。

1回目の実行では、無事にコピーがされるのですが、
2回目の実行で処理を再開させた時に

nextFile.makeCopy(nextFile.getName(), currentIteration.targetFolder);

の部分で下記エラーが出てしまいます。

発生している問題・エラーメッセージ

Exception: The parameters (String,(class)) don't match the method signature for DriveApp.File.makeCopy.
nextIteration	@ コード.gs:180
copyFolderRecursively	@ コード.gs:131
executeCopyProcess	@ コード.gs:74

該当のソースコード

  var LOCK_KEY = "COPY_PROCESS_LOCK";
  var MAX_RUNNING_TIME_MS = 5 * 60 * 1000;  //処理時間はデフォルト5分
  var RECURSIVE_ITERATOR_KEY = "RECURSIVE_ITERATOR_KEY";

function startTrigger() {
  //この関数を1日一回のクーロンなどで登録しておく
  
  // ステータスクリア
  StatusClear();

  // 開始日時をセルに記録
  getStartDateTime();
  
  // 終了日時のセルをクリアー
  ENDDateTimeClear();
 

  // セッション情報を削除して新しいセッションを開始
  PropertiesService.getScriptProperties().deleteProperty(RECURSIVE_ITERATOR_KEY);
  
  //バックアップトリガーを設定
  ScriptApp.newTrigger("executeCopyProcess").timeBased().everyMinutes(5).create();
}

function executeCopyProcess() {
  
  var lock = LockService.getScriptLock();

  //  スプレッドシートの読み込み
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  //  シートの選択
  const sheet = spreadsheet.getSheetByName('フォルダコピー');
  //  セルの選択
  const range1 = sheet.getRange('B3');
  //  セルの値を取得する
  const sourceFolderId = range1.getValue();
  //  セルの選択
  const range2 = sheet.getRange('B6');
  //  セルの値を取得する
  const targetFolderId = range2.getValue();

  var range3 = sheet.getRange('E6');
  //  セルの値を取得する
  var runStatus = range3.getValue();

  
  try {
    // Try to acquire the lock and proceed if successful
    if (lock.tryLock(5000)) {
      console.info("Lock acquired, starting copy process.");

      copyFolderRecursively(sourceFolderId, targetFolderId, runStatus);
    } else {
      console.info("Lock is already taken, skipping this run.");
    }
  } finally {
     
    //ステータスをRunningにセットする
    StatusRUN();
    // Release the lock when done
    lock.releaseLock();
  }
}

function endTrigger() {
  //executeCopyProcessトリガーを削除
  
  var triggers = ScriptApp.getProjectTriggers();
  
  for (var i = 0; i < triggers.length; i++) {
    var trigger = triggers[i];
    
    if (trigger.getHandlerFunction() == "executeCopyProcess") {
      ScriptApp.deleteTrigger(trigger);
    }
  }
}

function copyFolderRecursively(sourceFolderId, targetFolderId,runStatus) {
  
  var sourceFolder = DriveApp.getFolderById(sourceFolderId);
  var targetFolder = DriveApp.getFolderById(targetFolderId);

  var startTime = new Date().getTime();
  
  var recursiveIterator;


// [{folderName: String, fileIteratorContinuationToken: String?, folderIteratorContinuationToken: String}]
  var recursiveIterator = JSON.parse(PropertiesService.getScriptProperties().getProperty(RECURSIVE_ITERATOR_KEY));
  if (recursiveIterator !== null) {
    // verify that it's actually for the same folder
    if (sourceFolder.getName() !== recursiveIterator[0].folderName) {
      console.warn("Looks like this is a new folder. Clearing out the old iterator.");
      recursiveIterator = null;
    } else {
      console.info("Resuming session.");
    }
  }
  
  if (recursiveIterator === null) {
    console.info("Starting new session.");
    recursiveIterator = [];
    recursiveIterator.push(makeIterationFromFolders(sourceFolder, targetFolder));
    PropertiesService.getScriptProperties().setProperty(RECURSIVE_ITERATOR_KEY, JSON.stringify(recursiveIterator));
  }

  while (recursiveIterator.length > 0) {
    recursiveIterator = nextIteration(recursiveIterator, startTime);

    var currTime = new Date().getTime();
    var elapsedTimeInMS = currTime - startTime;
    var timeLimitExceeded = elapsedTimeInMS >= MAX_RUNNING_TIME_MS;
    if (timeLimitExceeded) {
      PropertiesService.getScriptProperties().setProperty(RECURSIVE_ITERATOR_KEY, JSON.stringify(recursiveIterator));
      console.info("Stopping loop after '%d' milliseconds. Please continue running.", elapsedTimeInMS);
      return;
    }
  }

  console.info("Done copying");
  getENDDateTime();
  StatusClear();
  PropertiesService.getScriptProperties().deleteProperty(RECURSIVE_ITERATOR_KEY);

  // executeCopyProcessのトリガーを削除
  endTrigger();
}

function makeIterationFromFolders(sourceFolder, targetFolder) {

//  if (!targetFolder) {
//    targetFolder = DriveApp.createFolder("New Target Folder"); // 適切なフォルダ名を設定してください
//  }

  return {
    folderName: sourceFolder.getName(),
    targetFolderName: targetFolder.getName(), 
    fileIteratorContinuationToken: sourceFolder.getFiles().getContinuationToken(),
    folderIteratorContinuationToken: sourceFolder.getFolders().getContinuationToken(),
    sourceFolder: sourceFolder,
    targetFolder: targetFolder,

  };
}

function nextIteration(recursiveIterator, startTime) {

  var currentIteration = recursiveIterator[recursiveIterator.length -1]; //配列の最後の要素（現在のイテレーション）を取得
  if (currentIteration.fileIteratorContinuationToken !== null) {
    var fileIterator = DriveApp.continueFileIterator(currentIteration.fileIteratorContinuationToken);
    if (fileIterator.hasNext()) {
      // process the next file
      var path = recursiveIterator.map(function(iteration) { return iteration.folderName; }).join("/");
      var nextFile = fileIterator.next();
      processFile(nextFile, path);
      
      nextFile.makeCopy(nextFile.getName(), currentIteration.targetFolder);
      
      currentIteration.fileIteratorContinuationToken = fileIterator.getContinuationToken();
      recursiveIterator[recursiveIterator.length -1] = currentIteration;
      return recursiveIterator;
    } else {
      // done processing files
      currentIteration.fileIteratorContinuationToken = null;
      recursiveIterator[recursiveIterator.length- 1] = currentIteration;
      return recursiveIterator;
    }
  }

  if (currentIteration.folderIteratorContinuationToken !== null) {
    var folderIterator = DriveApp.continueFolderIterator(currentIteration.folderIteratorContinuationToken);
    if (folderIterator.hasNext()) {
      // process the next folder
      var folder = folderIterator.next();
      recursiveIterator[recursiveIterator.length-1].folderIteratorContinuationToken = folderIterator.getContinuationToken();
      var newTargetSubfolder = currentIteration.targetFolder.createFolder(folder.getName()); // 新しいサブフォルダを作成
      recursiveIterator.push(makeIterationFromFolders(folder, newTargetSubfolder)); // ターゲットフォルダを更新した新しいイテレーションを追加
      
      return recursiveIterator;
    } else {
      // done processing subfolders
      recursiveIterator.pop();
      return recursiveIterator;
    }
  }
throw "should never get here";
}


function processFile(file, path) {
  console.log(path + "/" + file.getName());
}



function getStartDateTime() {
//現在時刻を取得
  var now = new Date();
  var year = now.getFullYear();
  var month = now.getMonth()+1;
  var date = now.getDate();
  var hour = now.getHours();
  var minute = now.getMinutes();
  var second = now.getSeconds();
 //入力したい文字列に整形する 
  var nowDate = year + "年" + month + "月" + date + "日" + hour + "時" + minute + "分" + second + "秒";
//  スプレッドシートの読み込み
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  //  シートの選択
  const sheet = spreadsheet.getSheetByName('フォルダコピー');
 //E3セルに時刻を入力
  sheet.getRange('E3').setValue(nowDate);
  
}

function getENDDateTime() {
//現在時刻を取得
  var nowE = new Date();
  var yearE = nowE.getFullYear();
  var monthE = nowE.getMonth()+1;
  var dateE = nowE.getDate();
  var hourE = nowE.getHours();
  var minuteE = nowE.getMinutes();
  var secondE = nowE.getSeconds();
 //入力したい文字列に整形する 
  var nowEDate = yearE + "年" + monthE + "月" + dateE + "日" + hourE + "時" + minuteE + "分" + secondE + "秒";
 //  スプレッドシートの読み込み
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  //  シートの選択
  const sheet = spreadsheet.getSheetByName('フォルダコピー');
  //E4セルに時刻を入力
  sheet.getRange('E4').setValue(nowEDate);
}

function ENDDateTimeClear() {
 //  スプレッドシートの読み込み
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  //  シートの選択
  const sheet = spreadsheet.getSheetByName('フォルダコピー');
  //E4セルに時刻を入力
  sheet.getRange('E4').clearContent();
}

function StatusClear() {
 //  スプレッドシートの読み込み
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  //  シートの選択
  const sheet = spreadsheet.getSheetByName('フォルダコピー');
  //E4セルに時刻を入力
  sheet.getRange('E6').clearContent();
}

function StatusRUN() {
 //  スプレッドシートの読み込み
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  //  シートの選択
  const sheet = spreadsheet.getSheetByName('フォルダコピー');
  //E4セルに時刻を入力
  sheet.getRange('E6').setValue("Running");
}

試したこと

自分でネットで調べたりChatGPTにアドバイスを貰ったりしながらエラー修正を
繰り返してここまで来ましたが行きづまってしまいました。

補足情報（FW/ツールのバージョンなど）

Google Apps Script

Comments

[YellowGreen]

makeCopyのときのtargetFolderがDriveAppで取得したものを
JSON.stringify()して、
JSON.parse()してそのまま使っているように思えますが、
改めてDriveAppで取得せずに使えるのでしょうか。

[takayuki2023]

コメントありがとうございます。
別の方にも同じようなアドバイスを頂いて、targetFolderの箇所に関する部分を修正することで
resume後の処理でコピー処理を引き継いで実行できることが確認できました。
今、大量ファイルコピーのテスト中ですのでテストが成功したら
完成版のコードをアップしようと思います。

Answer 1

下記のGASで動作確認が取れました。
皆さま、ご協力ありがとうございました。

修正箇所：
1.folderオブジェクトの代わりにidをjson化/parseして、idでfolderオブジェクトを取得するように変更しています。

return {
// 中略
targetFolder: targetFolder,
};
↓修正。
return {
// 中略
targetFolderId:targetFolder.getId(),
}

;

さらに、
currentIteration.targetFolder
の所を全て
DriveApp.getFolderById(currentIteration.targetFolderId)
に修正。

2.lock.releaseLock();の記述位置を変更。
3.処理時間を3分、トリガーを1分毎に設定。

GAS本文はこちらです。

  var LOCK_KEY = "COPY_PROCESS_LOCK";
  var MAX_RUNNING_TIME_MS = 3 * 60 * 1000;  //GASの処理時間はデフォルト3分
  var RECURSIVE_ITERATOR_KEY = "RECURSIVE_ITERATOR_KEY";

function startTrigger() {
  //この関数を1日一回のクーロンなどで登録しておく
  
  // ステータスクリア
  StatusClear();

  // 開始日時をセルに記録
  getStartDateTime();
  
  // 終了日時のセルをクリアー
  ENDDateTimeClear();

  

  // セッション情報を削除して新しいセッションを開始
  PropertiesService.getScriptProperties().deleteProperty(RECURSIVE_ITERATOR_KEY);
  
  //バックアップトリガーを設定
  ScriptApp.newTrigger("executeCopyProcess").timeBased().everyMinutes(1).create();   //トリガーは1分毎に実行
}

function executeCopyProcess() {
  
  var lock = LockService.getScriptLock();

  //  スプレッドシートの読み込み
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  //  シートの選択
  const sheet = spreadsheet.getSheetByName('フォルダコピー');
  //  セルの選択
  const range1 = sheet.getRange('B3');
  //  セルの値を取得する
  const sourceFolderId = range1.getValue();
  //  セルの選択
  const range2 = sheet.getRange('B6');
  //  セルの値を取得する
  const targetFolderId = range2.getValue();

  var range3 = sheet.getRange('E6');
  //  セルの値を取得する
  var runStatus = range3.getValue();

  
  try {
    // Try to acquire the lock and proceed if successful
    if (lock.tryLock(5000)) {
      console.info("Lock acquired, starting copy process.");

      copyFolderRecursively(sourceFolderId, targetFolderId );
      // 一応スリープ
      Utilities.sleep(2000);
      // Release the lock when done
      lock.releaseLock();
    } else {
      console.info("Lock is already taken, skipping this run.");
    }
  } finally {
     
    //ステータスをRunningにセットする
    StatusRUN();
   
  }
}

function endTrigger() {
  //executeCopyProcessトリガーを削除
  
  var triggers = ScriptApp.getProjectTriggers();
  
  for (var i = 0; i < triggers.length; i++) {
    var trigger = triggers[i];
    
    if (trigger.getHandlerFunction() == "executeCopyProcess") {
      ScriptApp.deleteTrigger(trigger);
    }
  }
}

function copyFolderRecursively(sourceFolderId, targetFolderId) {
  
  var sourceFolder = DriveApp.getFolderById(sourceFolderId);
  var targetFolder = DriveApp.getFolderById(targetFolderId);

  var startTime = new Date().getTime();
  
  var recursiveIterator;


// [{folderName: String, fileIteratorContinuationToken: String?, folderIteratorContinuationToken: String}]
  var recursiveIterator = JSON.parse(PropertiesService.getScriptProperties().getProperty(RECURSIVE_ITERATOR_KEY));
  if (recursiveIterator !== null) {
    // verify that it's actually for the same folder
    if (sourceFolder.getName() !== recursiveIterator[0].folderName) {
      console.warn("Looks like this is a new folder. Clearing out the old iterator.");
      recursiveIterator = null;
    } else {
      console.info("Resuming session.");
    }
  }
  
  if (recursiveIterator === null) {
    console.info("Starting new session.");
    recursiveIterator = [];
    recursiveIterator.push(makeIterationFromFolders(sourceFolder, targetFolder));
    PropertiesService.getScriptProperties().setProperty(RECURSIVE_ITERATOR_KEY, JSON.stringify(recursiveIterator));
  }

  while (recursiveIterator.length > 0) {
    recursiveIterator = nextIteration(recursiveIterator, startTime);

    var currTime = new Date().getTime();
    var elapsedTimeInMS = currTime - startTime;
    var timeLimitExceeded = elapsedTimeInMS >= MAX_RUNNING_TIME_MS;
    if (timeLimitExceeded) {
      PropertiesService.getScriptProperties().setProperty(RECURSIVE_ITERATOR_KEY, JSON.stringify(recursiveIterator));
      console.info("Stopping loop after '%d' milliseconds. Please continue running.", elapsedTimeInMS);
      return;
    }
  }

  console.info("Done copying");
  getENDDateTime();
  StatusClear();
  PropertiesService.getScriptProperties().deleteProperty(RECURSIVE_ITERATOR_KEY);

  // executeCopyProcessのトリガーを削除
  endTrigger();
}

function makeIterationFromFolders(sourceFolder, targetFolder) {

  return {
    folderName: sourceFolder.getName(),
    targetFolderName: targetFolder.getName(), 
    fileIteratorContinuationToken: sourceFolder.getFiles().getContinuationToken(),
    folderIteratorContinuationToken: sourceFolder.getFolders().getContinuationToken(),
    sourceFolder: sourceFolder,
    targetFolderId:targetFolder.getId(),

  };
}

function nextIteration(recursiveIterator, startTime) {

  var currentIteration = recursiveIterator[recursiveIterator.length -1]; //配列の最後の要素（現在のイテレーション）を取得
  if (currentIteration.fileIteratorContinuationToken !== null) {
    var fileIterator = DriveApp.continueFileIterator(currentIteration.fileIteratorContinuationToken);
    if (fileIterator.hasNext()) {
      // process the next file
      var path = recursiveIterator.map(function(iteration) { return iteration.folderName; }).join("/");
      var nextFile = fileIterator.next();
      processFile(nextFile, path);
      
      nextFile.makeCopy(nextFile.getName(), DriveApp.getFolderById(currentIteration.targetFolderId));
      
      currentIteration.fileIteratorContinuationToken = fileIterator.getContinuationToken();
      recursiveIterator[recursiveIterator.length -1] = currentIteration;
      return recursiveIterator;
    } else {
      // done processing files
      currentIteration.fileIteratorContinuationToken = null;
      recursiveIterator[recursiveIterator.length- 1] = currentIteration;
      return recursiveIterator;
    }
  }

  if (currentIteration.folderIteratorContinuationToken !== null) {
    var folderIterator = DriveApp.continueFolderIterator(currentIteration.folderIteratorContinuationToken);
    if (folderIterator.hasNext()) {
      // process the next folder
      var folder = folderIterator.next();
      recursiveIterator[recursiveIterator.length-1].folderIteratorContinuationToken = folderIterator.getContinuationToken();
      var newTargetSubfolder = DriveApp.getFolderById(currentIteration.targetFolderId).createFolder(folder.getName()); // 新しいサブフォルダを作成
      recursiveIterator.push(makeIterationFromFolders(folder, newTargetSubfolder)); // ターゲットフォルダを更新した新しいイテレーションを追加
      
      return recursiveIterator;
    } else {
      // done processing subfolders
      recursiveIterator.pop();
      return recursiveIterator;
    }
  }
throw "should never get here";
}


function processFile(file, path) {
  console.log(path + "/" + file.getName());
}



function getStartDateTime() {
//現在時刻を取得
  var now = new Date();
  var year = now.getFullYear();
  var month = now.getMonth()+1;
  var date = now.getDate();
  var hour = now.getHours();
  var minute = now.getMinutes();
  var second = now.getSeconds();
 //入力したい文字列に整形する 
  var nowDate = year + "年" + month + "月" + date + "日" + hour + "時" + minute + "分" + second + "秒";
//  スプレッドシートの読み込み
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  //  シートの選択
  const sheet = spreadsheet.getSheetByName('フォルダコピー');
 //E3セルに時刻を入力
  sheet.getRange('E3').setValue(nowDate);
  
}

function getENDDateTime() {
//現在時刻を取得
  var nowE = new Date();
  var yearE = nowE.getFullYear();
  var monthE = nowE.getMonth()+1;
  var dateE = nowE.getDate();
  var hourE = nowE.getHours();
  var minuteE = nowE.getMinutes();
  var secondE = nowE.getSeconds();
 //入力したい文字列に整形する 
  var nowEDate = yearE + "年" + monthE + "月" + dateE + "日" + hourE + "時" + minuteE + "分" + secondE + "秒";
 //  スプレッドシートの読み込み
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  //  シートの選択
  const sheet = spreadsheet.getSheetByName('フォルダコピー');
  //E4セルに時刻を入力
  sheet.getRange('E4').setValue(nowEDate);
}

function ENDDateTimeClear() {
 //  スプレッドシートの読み込み
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  //  シートの選択
  const sheet = spreadsheet.getSheetByName('フォルダコピー');
  //E4セルに時刻を入力
  sheet.getRange('E4').clearContent();
}

function StatusClear() {
 //  スプレッドシートの読み込み
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  //  シートの選択
  const sheet = spreadsheet.getSheetByName('フォルダコピー');
  //E4セルに時刻を入力
  sheet.getRange('E6').clearContent();
}

function StatusRUN() {
 //  スプレッドシートの読み込み
  const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  //  シートの選択
  const sheet = spreadsheet.getSheetByName('フォルダコピー');
  //E4セルに時刻を入力
  sheet.getRange('E6').setValue("Running");
}