G AppScript Search Files 搜索Google Drive文件结果偏差问题

原生DriveApp.searchFiles()默认检索范围存在限制：

• 默认仅覆盖「我的云端硬盘」、直接共享给当前账号的文件，不会主动纳入所有共享团队盘内的资源
• 默认未开启跨盘检索参数，通过文件夹层级继承权限、未给账号单独开显式权限的文件会被漏检
• 未排除回收站文件时，结果会混入已删除内容，和网页端默认显示逻辑不一致

方案1：基于原生DriveApp修改（改动量最小） #

直接在原有代码基础上增加全范围检索参数即可，不需要额外引入服务：

function SearchFiles() {
  var searchFor ='title contains "find ME" and trashed = false';
  var names =[];
  var fileIds=[];
  // 新增全范围检索配置，覆盖所有团队盘、所有多层级子文件夹
  var searchOption = {
    includeItemsFromAllDrives: true,
    supportsAllDrives: true,
    corpora: "allDrives"
  };
  var files = DriveApp.searchFiles(searchFor, searchOption);
  while (files.hasNext()) {
    var file = files.next();
    var fileId = file.getId();
    fileIds.push(fileId);
    var name = file.getName();
    names.push(name);
  }

  for (var i=0;i<names.length;i++){
    Logger.log(names[i]);
    Logger.log("文件对应ID：" + fileIds[i]);
  }
  // 后续移动文件逻辑可直接在下方补充，调用file.moveTo()时会自动继承跨盘权限
}

方案2：基于高级Drive API实现（兼容性更好） #

如果方案1运行提示参数不兼容，可使用官方高级Drive服务实现，检索逻辑和网页端完全对齐：

前置操作：打开脚本编辑器左侧边栏「服务」板块，点击+号，在服务列表中选择「Drive API」，版本选v3后点击添加完成授权

function SearchFiles() {
  var searchFor = 'name contains "find ME" and trashed = false';
  var names = [];
  var fileIds = [];
  var pageToken = null;

  do {
    var response = Drive.Files.list({
      q: searchFor,
      includeItemsFromAllDrives: true,
      supportsAllDrives: true,
      corpora: "allDrives",
      fields: "nextPageToken, files(id, name)",
      pageSize: 1000,
      pageToken: pageToken
    });
    if (response.files && response.files.length > 0) {
      response.files.forEach(function(file) {
        fileIds.push(file.id);
        names.push(file.name);
      })
    }
    pageToken = response.nextPageToken;
  } while (pageToken);

  for (var i = 0; i < names.length; i++) {
    Logger.log(names[i]);
    Logger.log("文件对应ID：" + fileIds[i]);
  }
}

• 上述两种方案的检索范围和Google Drive网页端完全一致，覆盖当前账号有权限访问的所有位置，包括所有共享团队盘、任意深度的多层级子文件夹
• 搜索条件中加入trashed = false是为了过滤回收站中的文件，和网页端默认搜索逻辑对齐，如需检索已删除文件删除该条件即可
• 后续执行批量移动操作时，需确保账号对源文件有编辑权限、对目标文件夹有内容上传权限，跨团队盘移动时上述参数已自动适配权限要求，无需额外配置

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