You need to enable JavaScript to run this app. Google Apps Script 按文件名匹配获取不同文件夹内的文件ID
优惠活动
大模型
产品
解决方案
定价
更多

Google Apps Script 按文件名匹配获取不同文件夹内的文件ID

跨文件夹检索Google Drive文件ID的实现方案

你当前使用的脚本仅能匹配和电子表格同直接父文件夹下的文件,核心原因是原逻辑只调用了当前根文件夹的getFilesByName()方法,既不会向下扫描嵌套子文件夹,也无法覆盖云盘中其他独立路径下的目标文件。可通过以下改造实现跨文件夹的全范围检索。

递归覆盖根文件夹下所有嵌套子文件夹

要实现子文件夹内的文件检索,核心是将单次的文件夹层级查询改为递归遍历,一次性把根目录下所有嵌套层级的文件全部纳入检索池。相较于在每个子文件夹下逐次调用按文件名查询的接口,提前构建「文件名-文件ID」映射表的方式能大幅减少API调用次数,降低脚本运行超时、触发配额限制的概率。

以下是改造后的可直接运行的完整脚本:

function myFunction() {
  const ss = SpreadsheetApp.getActive();
  const SSID = ss.getId();
  const spreadsheetFile = DriveApp.getFileById(SSID);
  // 获取当前电子表格所在的根父文件夹
  const rootFolder = spreadsheetFile.getParents().next();
  const sh = ss.getSheetByName('Sheet4');
  const filenames = sh.getRange('B3:B').getValues().flat().filter(r => r !== '');

  // 存储全局文件映射:键为文件名,值为对应文件ID的数组
  const fileMap = {};

  /**
   * 递归遍历目标文件夹下的所有文件和子文件夹
   * @param {DriveApp.Folder} targetFolder 待遍历的文件夹对象
   */
  function traverseFolder(targetFolder) {
    // 收集当前文件夹层级下的所有文件
    const currentFiles = targetFolder.getFiles();
    while (currentFiles.hasNext()) {
      const file = currentFiles.next();
      const fileName = file.getName();
      if (!fileMap[fileName]) {
        fileMap[fileName] = [];
      }
      fileMap[fileName].push(file.getId());
    }
    // 递归遍历所有子文件夹
    const subFolders = targetFolder.getFolders();
    while (subFolders.hasNext()) {
      traverseFolder(subFolders.next());
    }
  }

  // 从根文件夹启动全量遍历
  traverseFolder(rootFolder);

  // 根据B列的目标文件名匹配对应ID
  const IDs = [];
  filenames.forEach(targetName => {
    if (fileMap[targetName]) {
      // 同一文件名匹配到多个文件时,逐行写入所有ID
      fileMap[targetName].forEach(fileId => IDs.push([fileId]));
    }
  });

  // 清空C列旧数据后写入新匹配的结果
  const clearRange = sh.getRange(3, 3, Math.max(sh.getLastRow() - 2, 1), 1);
  clearRange.clearContent();
  if (IDs.length > 0) {
    sh.getRange(3, 3, IDs.length, 1).setValues(IDs);
  }
}

扩展支持检索其他独立文件夹

如果需要检索的文件不在当前根文件夹的嵌套层级下,而是在云盘内其他独立路径中,只需在遍历启动阶段把这些额外的文件夹ID加入遍历列表即可,不需要修改核心的递归逻辑。
调整方式参考以下片段:

function myFunction() {
  // ...前面原有逻辑保持不变
  // traverseFolder函数定义保持不变

  // 配置需要纳入检索范围的其他独立文件夹ID
  const extraFolderIds = [
    '替换为第一个独立文件夹的ID',
    '替换为第二个独立文件夹的ID'
  ];

  // 启动遍历:先扫当前根文件夹
  traverseFolder(rootFolder);
  // 再依次遍历所有额外指定的独立文件夹
  extraFolderIds.forEach(folderId => {
    traverseFolder(DriveApp.getFolderById(folderId));
  });

  // ...后面匹配ID、写入表格的逻辑保持不变
}

实用注意事项

  • 只要是当前账号拥有访问权限的文件夹和文件,递归遍历都能正常识别,不存在嵌套层级的限制
  • 同名文件不会出现匹配遗漏,脚本会把所有同名文件的ID逐行写入C列
  • 如果云盘内文件总量过万,可根据实际需求调整遍历范围,避免单次运行遍历全部文件导致耗时过长
  • 脚本会自动清空C列原有旧值,不会因为多次运行出现重复堆积的旧数据

内容的提问来源于stack exchange,提问作者cjvdg

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 00:36:01