Node.js调用Google Drive API获取指定文件夹内容的权限范围问题

问题回顾 #

之前调用drive.files.list返回空文件夹是因为缺少drive.readonly权限，但添加该权限后又能获取用户所有文件，现在需要实现仅访问目标特定文件夹的需求。

可行，用这两个方法实现 #

1. 换用更窄的权限范围：drive.file #

Google Drive API的https://www.googleapis.com/auth/drive.file权限专门用于限制应用仅访问自身创建或用户明确授权的文件/文件夹。

• 因为你的目标文件夹是API创建的，应用自动拥有对它的访问权，包括读取里面的内容。
• 用这个权限后，drive.files.list只会返回应用有权限的资源，不会拿到用户的全部Drive文件。

2. 给查询条件加双重过滤 #

配合权限范围，在q参数里补充过滤规则，确保结果精准：

drive.files.list({
    q: `'${dataSource.folder_id}' in parents and trashed = false`,
    fields: 'files(id, name, mimeType)'
}, (err, res) => {
    if (err) {
        console.error('读取文件夹内容出错:', err);
        return;
    }
          
    const contents = res.data.files;
    if (contents && contents.length > 0) {
        console.log('文件夹内容:');
        contents.forEach(file => {
             console.log('文件名:', file.name);
             console.log('文件ID:', file.id);
             console.log('文件类型:', file.mimeType);
             console.log('---');
        });
    } else {
        console.log('文件夹为空。');
    }
});

• 添加trashed = false可以排除回收站里的文件，避免无效结果。

操作步骤验证 #

1. 把认证时的权限范围替换成https://www.googleapis.com/auth/drive.file
2. 如果是OAuth2授权，需要让用户重新授权（因为权限范围变了）
3. 运行代码，此时只会返回目标文件夹内的文件，不会触及用户其他Drive内容

补充说明 #

• 目标文件夹设置的“任何有链接的人可访问”权限可以保留，但drive.file已经足够让应用访问它，不需要依赖公共链接。
• 如果后续用户手动往这个文件夹加文件，要么让用户授权该文件给应用，要么保持文件夹的公共权限，应用就能读取到新增内容。

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