如何用App Script为共享云端硬盘文件添加自定义属性并解决搜索报错

问题根源 #

你遇到的Exception: Invalid argument: q错误主要来自两个原因：

1. 查询语法错误：你用了普通自定义属性（properties）的搜索语法，但实际添加的是应用专属属性（appProperties），二者查询规则不同。
2. 共享盘搜索范围未指定：DriveApp默认不会搜索共享云端硬盘的文件，需要额外参数开启。

另外你代码里还有两个小问题：hasNext少了括号（应为hasNext()），以及拼写错误founded（应为found）。

修正方案 #

方案1：使用DriveApp修正搜索逻辑 #

调整查询语法，并添加共享盘支持参数：

function getProperty() {
  // appProperties的正确查询语法
  var query = "appProperties.department = 'Sales'";
  // 开启共享云端硬盘搜索支持
  var searchOptions = {
    includeItemsFromAllDrives: true,
    supportsAllDrives: true
  };
  
  var files = DriveApp.searchFiles(query, searchOptions);
  
  if(files.hasNext()) {
    var file = files.next();
    console.log(file.getName());
  } else {
    console.log("No file found");
  }
}

方案2：使用Advanced Drive Service（推荐，与你添加属性的方式统一） #

既然你已经在使用Advanced Drive Service管理属性，用它搜索会更灵活，适配共享盘场景：

function getPropertyWithAdvancedService() {
  try {
    var searchParams = {
      q: "appProperties.department = 'Sales'",
      includeItemsFromAllDrives: true,
      supportsAllDrives: true,
      fields: "files(id, name, appProperties)"
    };
    var searchResult = Drive.Files.list(searchParams);
    var targetFiles = searchResult.files;
    
    if (targetFiles && targetFiles.length > 0) {
      targetFiles.forEach(file => {
        console.log('文件名: %s, 属性: %s', file.name, JSON.stringify(file.appProperties));
      });
    } else {
      console.log("No file found");
    }
  } catch (err) {
    console.log('Failed with error %s', err.message);
  }
}

关键注意事项 #

• 启用Advanced Drive Service：在App Script编辑器中，点击「服务」>「添加服务」，找到「Drive API」并启用（方案2需要）。
• 权限验证：确保运行脚本的账号拥有目标共享云端硬盘的查看权限。
• 语法区分：
  • 应用专属属性（appProperties）：查询用appProperties.属性名 = '值'
  • 普通自定义属性（properties）：查询用properties has { key='属性名' and value='值' }

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