AppScript通过文件ID获取Drive文件夹路径返回全量文件问题排查

• 已通过GCP/GAMadv拉取Google Drive活动报告，报告包含Workspace域内所有用户的文件ID，相关数据已存储在Google Sheet中
• 实现目标：基于文件ID查询对应文件的完整文件夹路径，基于AppScript开发
• 原实现代码如下：

function getFolderPath(fileID, folderPath =""){
  var sheetID = "1YfZgkLvAnPj7kOIQOVkcXeJgnh-KTecMn6er1a0elkk"
  var sheet = SpreadsheetApp.openById(sheetID)
  // var file = sheet.Files.get(fileID)
  var parent = Drive.Files.get(fileID);
  console.log(parent)
  // console.log(file)
  var parentElement = parent.items[0]

  console.log(parentElement)
  // var parentElement = parent[0]

  var parentFile = Drive.Files.get(parent.id);
  var parentPath = parentFile.title;

  if (parent.isRoot)
  return "/" + folderPath;
  else {
    return getFolderPath(
      parentFile.id,
      parentPath + "/" + folderPath
    );
  }
}

• 异常现象：运行代码后函数未返回指定ID对应文件的文件夹路径，返回Drive全量文件数据。

原代码存在4个核心逻辑错误：

1. API返回结构适配错误：Drive.Files.get()是单文件查询接口，直接返回单个文件的元数据对象，不存在items字段（items是Drive.Files.list()这类列表查询接口的返回字段，值为全量文件数组），代码中残留的列表接口取值逻辑是返回全量文件的直接原因。
2. 父级文件夹获取逻辑完全失效：文件的父级目录信息存储在返回对象的parents数组中，原代码未读取该字段，反而直接取当前查询文件自身的id重复发起查询，递归始终在同一个文件上循环，根本没有向上遍历目录结构。
3. 根目录判断逻辑错误：isRoot属性属于父级文件夹对象，不属于当前查询的文件对象，原判断条件永远无法触发。
4. 冗余调用拖慢性能：每次递归都重新打开一次Spreadsheet，这部分逻辑和路径查询完全无关，会额外增加执行耗时、触发服务配额限制。

// 全局初始化表格实例，仅执行一次，避免重复调用
const TARGET_SHEET_ID = "1YfZgkLvAnPj7kOIQOVkcXeJgnh-KTecMn6er1a0elkk";
const spreadsheet = SpreadsheetApp.openById(TARGET_SHEET_ID);
// 加路径缓存，避免同个文件重复查询触发API配额
const pathCache = CacheService.getScriptCache();

/**
 * 传入文件ID查询完整云端路径
 * @param {string} fileID 目标Google Drive文件ID
 * @param {string} [folderPath=""] 递归用路径前缀，外部调用无需传参
 * @returns {string} 完整文件路径，格式为 /根目录/二级目录/文件名
 */
function getFolderPath(fileID, folderPath = ""){
  // 先查缓存，命中直接返回
  const cacheKey = `drive_path_${fileID}`;
  const cachePath = pathCache.get(cacheKey);
  if (cachePath && !folderPath) return cachePath;

  // 仅查询需要的字段，降低请求负载
  const currentNode = Drive.Files.get(fileID, {
    fields: "id,title,parents(id,isRoot,title)"
  });
  const currentFullPath = currentNode.title + (folderPath ? `/${folderPath}` : "");

  // 取第一个父级（Google Drive文件允许存在多个父目录，默认取第一个挂载路径）
  const parentNode = currentNode.parents[0];
  // 父级为根目录时拼接根路径返回
  if (parentNode.isRoot) {
    const finalPath = `/${currentFullPath}`;
    // 写入缓存，缓存有效期6小时
    pathCache.put(cacheKey, finalPath, 21600);
    return finalPath;
  }

  // 递归向上查询父目录路径
  return getFolderPath(parentNode.id, currentFullPath);
}

• 运行前需要在AppScript编辑器左侧「服务」栏添加Drive API高级服务，API版本选择v2，否则会报接口不存在错误。
• 支持直接作为表格自定义函数使用：如果文件ID存放在A列，在B2单元格输入=getFolderPath(A2)下拉即可批量计算所有文件的完整路径。
• 如果查询域内其他用户的文件出现权限报错，需要在Google Workspace管理后台给绑定的服务账号授予全域Drive数据查看权限，否则无法读取无共享权限的文件元数据。
• 批量查询超过1000条数据时，建议分批执行，避免短时间请求过多触发Drive API的每分钟调用配额限制。

内容的提问来源于stack exchange，提问作者beforesunset_mj