服务账号模拟用户调用Drive API无法访问共享文件夹文件问题

我有一个Google Drive文件夹，由服务账号创建并共享给个人用户：

• 个人用户可在UI界面正常查看该文件夹；
• 服务账号自身通过API能列出文件夹内所有文件；
  个人用户已获得该文件夹的编辑权限。现在需要通过服务账号模拟个人用户调用Drive API获取该文件夹的文件列表，已配置全域委派并添加了https://www.googleapis.com/auth/drive.file和https://www.googleapis.com/auth/drive权限范围，但模拟调用时返回0条结果，服务账号自身调用则返回100条结果。

代码如下：

const auth = new google.auth.GoogleAuth({
    clientOptions: {
        subject: 'myemail@myorganization.com'
    },
    keyFile: './token.json',
    scopes: ['https://www.googleapis.com/auth/drive.file'],
});

drive.files.list({
    q: "'THE_FOLDER_ID' in parents",
    fields: 'nextPageToken, files(id, name, parents,  appProperties)',
    includeItemsFromAllDrives: true,
    supportsAllDrives: true,
    fields: '*',
    spaces: 'drive'
}).then(response => {
    console.log(response.data.files.length)
})

1. 调整权限范围 #

代码中使用的drive.file权限范围是基于用户主动授权特定文件/文件夹的范围，服务账号模拟个人用户时，个人用户并未通过OAuth流程给应用授权过目标文件夹，因此该范围无法获取内容。

将授权范围替换为已在全域委派中配置的https://www.googleapis.com/auth/drive：

const auth = new google.auth.GoogleAuth({
    clientOptions: {
        subject: 'myemail@myorganization.com'
    },
    keyFile: './token.json',
    scopes: ['https://www.googleapis.com/auth/drive'], // 修改此处
});

2. 修正查询参数冗余问题 #

代码中重复声明了fields参数，可能导致解析异常，保留一个即可。同时可根据需求指定具体字段（避免用*更规范），修正后的调用如下：

drive.files.list({
    q: "'THE_FOLDER_ID' in parents",
    includeItemsFromAllDrives: true,
    supportsAllDrives: true,
    fields: 'nextPageToken, files(id, name, parents, appProperties)'
}).then(response => {
    console.log(response.data.files.length)
})

3. 验证全域委派配置 #

确保在Google Workspace管理控制台中：

• 已为服务账号启用全域委派；
• https://www.googleapis.com/auth/drive已添加到授权范围列表；
• 模拟的个人用户属于你的Google Workspace域内（全域委派仅对域内用户生效）。

4. 确认文件夹共享权限 #

检查Drive UI中文件夹的共享设置，确保个人用户是被直接添加的权限持有者（而非通过组继承），且权限级别为编辑/查看者。

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