Google Apps Script：如何基于文件ID数组实现fullText搜索？

核心思路 #

直接针对给定的文件ID数组逐个验证，结合Drive API的文件资源获取能力，覆盖文件名、描述及可索引内容的匹配，无需绑定特定文件夹或遍历整个云端硬盘。

具体实现步骤 #

• 遍历目标文件ID数组，通过DriveApp.getFileById(fileId)逐个获取文件对象
• 加入权限异常处理，避免因文件不可访问导致流程中断
• 分别检查文件名、文件描述，再尝试提取文件文本内容进行匹配，任一维度命中即标记为匹配文件

示例代码 #

function searchFilesByIds(fileIds, targetString) {
  const matchedFiles = [];
  
  for (const fileId of fileIds) {
    try {
      const file = DriveApp.getFileById(fileId);
      // 检查文件名
      const nameHit = file.getName().includes(targetString);
      // 检查文件描述
      const descHit = file.getDescription()?.includes(targetString) || false;
      
      // 检查文件内容（仅支持可转换为文本的文件类型）
      let contentHit = false;
      try {
        const textContent = file.getAs('text/plain').getDataAsString();
        contentHit = textContent.includes(targetString);
      } catch (err) {
        console.log(`文件 ${fileId} 无法提取文本内容: ${err.message}`);
      }
      
      // 任一匹配则存入结果
      if (nameHit || descHit || contentHit) {
        matchedFiles.push({
          id: fileId,
          name: file.getName(),
          matchSource: nameHit ? '文件名' : descHit ? '文件描述' : '文件内容'
        });
      }
    } catch (err) {
      console.log(`无法访问文件 ${fileId}: ${err.message}`);
    }
  }
  
  return matchedFiles;
}

// 使用示例
const targetFileIds = ['file-id-xxx', 'file-id-yyy', 'file-id-zzz'];
const searchStr = '你要找的特定字符串';
const result = searchFilesByIds(targetFileIds, searchStr);
console.log('匹配结果:', result);

注意事项 #

• 非文本类文件（如图片、压缩包）无法提取内容，只会检查文件名和描述
• 确保脚本拥有目标文件的访问权限，共享文件需提前在Drive中完成授权
• 文件数量较多时，可添加Utilities.sleep(100)控制调用频率，避免触发API限制

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