Node.js调用Google Drive API无法获取appProperties字段问题

我之前碰到过类似的问题，给你几个实用的排查方向：

1. 先确认你用的是Drive API v3，不是v2 #

这大概率是核心原因！Google Drive API v2和v3的字段命名有明显区别：

• v3里的appProperties在v2中对应的是properties（而且v2的properties没有区分私有/共享属性）
• 你的googleapis@29.0.0版本默认可能会调用Drive API v2，而你在API测试平台用的是v3，这就导致了list接口拿不到字段但get接口能拿到的矛盾情况。

解决方法很简单：初始化Drive客户端时显式指定版本为v3：

const { google } = require('googleapis');
// 注意这里要加上version: 'v3'
const drive = google.drive({ version: 'v3', auth: yourAuthInstance });

2. 检查appProperties的应用归属 #

appProperties是应用私有字段——只有写入这个字段的应用（使用同一个OAuth客户端ID）才能读取它。不过你提到在API开发者平台调用files.get能拿到，说明大概率是同一个身份，这条可以先排除，但如果上面的方法没用，可以确认一下当前应用的客户端ID和设置appProperties时的客户端ID是否一致。

3. 直接写死fields参数，排除拼接错误 #

虽然你的拼接逻辑看起来没问题，但有时候多余的空格或者意外的字符可能会导致字段被API忽略。可以尝试直接写死fields参数快速验证：

return drive.files.list({
  pageSize: 200,
  fields: 'nextPageToken, files(id, name, mimeType, parents, description, modifiedTime, appProperties)',
  q: queryString
});

4. 考虑升级googleapis版本（可选） #

googleapis@29.0.0是2018年左右的老版本，可能存在一些API兼容性问题。如果上面的方法都没解决，可以尝试升级到较新的版本：

npm install googleapis@latest

另外，你可以开启调试日志查看实际发送的请求详情，确认fields参数是否正确传递：

google.options({ debug: true });

这样能看到完整的请求URL和参数，帮你快速定位问题。

内容的提问来源于stack exchange，提问作者Mk-Etlinger