Google Drive API Node.js快速启动示例异常：文件信息不符且筛选无效

我之前也碰到过一模一样的情况，这俩问题其实都是API默认行为和参数格式不对导致的，咱们一步步拆解解决：

一、为什么返回的文件远多于「我的云端硬盘」里的内容？ #

默认的files.list()调用会返回你账号有权访问的所有文件，范围比你看到的「我的云端硬盘」大得多，包括：

• 他人共享给你的文件/文件夹
• 团队云端硬盘里的内容（如果你的账号加入了团队）
• 回收站里未彻底删除的文件
• 甚至Google Docs自带的模板文件（你没手动添加但系统默认存在的）

要只获取「我的云端硬盘」里的内容，必须在查询参数里加上两个关键限制：

1. 限定文件位于「我的云端硬盘」根目录或其子目录
2. 排除回收站中的文件

对应的查询语句是：

q: "'root' in parents and trashed=false"

二、为什么查询字符串筛选没效果？ #

你写的q: mimeType='image/jpeg'格式有问题——API要求查询条件必须是完整字符串，而且多条件组合时要正确用逻辑运算符连接。比如要筛选「我的云端硬盘里的JPG图片」，正确写法是：

q: "'root' in parents and trashed=false and mimeType='image/jpeg'"

另外要注意几个细节：

• 所有查询条件必须整体作为q参数的字符串值
• 字符串类型的字段值（比如mimeType）要用单引号包裹
• 筛选文件夹的话，对应的mimeType是'application/vnd.google-apps.folder'

完整修正后的代码片段 #

把这些条件加到你的files.list调用里，示例如下：

async function listFiles(auth) {
  const drive = google.drive({version: 'v3', auth});
  const res = await drive.files.list({
    pageSize: 10, // 可按需调整显示数量
    fields: 'nextPageToken, files(id, name, mimeType)', // 指定需要返回的字段
    q: "'root' in parents and trashed=false and mimeType='application/vnd.google-apps.folder'" // 仅获取我的云端硬盘中的文件夹
  });
  const files = res.data.files;
  if (files.length === 0) {
    console.log('No files found.');
    return;
  }
  console.log('Files:');
  files.map((file) => {
    console.log(`${file.name} (${file.id})`);
  });
}

额外排查点 #

如果还是有异常，可以检查这几点：

• 确认API调用使用的是你当前登录账号的授权（有时候可能误用到测试账号或其他账号的token）
• 查看返回文件的parents字段，确认它们实际所属的目录是否在「我的云端硬盘」外
• 检查回收站是否有大量未删除文件，trashed=false可以直接排除这些内容

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