Node项目中Google Drive v3 API文件所有权转移失败问题

核心错误点分析 #

• API方法与参数冲突：你在permissions.update请求中同时传递了permissionId和email参数，导致API无法正确识别目标权限；另外转移所有权的逻辑需区分目标用户是否已有文件权限：
  • 若目标用户无任何文件权限，应使用permissions.create而非update
  • 若目标用户已有权限，update时只需指定对应其权限的permissionId，无需email参数
• 前置条件未满足：Google Drive要求，转移所有权前目标用户必须已被添加为文件协作者（至少拥有查看权限），否则即使API返回200，实际也不会完成所有权转移
• 代码变量笔误：你用res接收API响应，但日志和返回语句调用的是未定义的result，会导致控制台报错，影响问题排查

修复后的代码示例 #

情况1：目标用户无文件权限（创建权限并转移所有权） #

async function transferOwner() {
  const authClient = await authorize();
  const realFileId = '***fileId***';
  const newOwnerEmail = 'xxx@gmail.com';
  try {
    const drive = google.drive({ version: 'v3', auth: authClient });

    // 为目标用户创建权限并直接转移所有权
    const res = await drive.permissions.create({
      fileId: realFileId,
      transferOwnership: true,
      sendNotificationEmail: true,
      resource: {
        role: 'owner',
        type: 'user',
        emailAddress: newOwnerEmail
      }
    });

    console.log(res.data);
    console.log(`已将所有权转移给 ${newOwnerEmail}`);
    return res.data;
  } catch (err) {
    console.log(`无法将所有权转移给 ${newOwnerEmail}`);
    console.log(err);
    throw err;
  }
}

情况2：目标用户已有文件权限（更新现有权限为所有者） #

async function transferOwner() {
  const authClient = await authorize();
  const realFileId = '***fileId***';
  const targetPermissionId = '***目标用户的权限ID***';
  const newOwnerEmail = 'xxx@gmail.com';
  try {
    const drive = google.drive({ version: 'v3', auth: authClient });

    const res = await drive.permissions.update({
      fileId: realFileId,
      permissionId: targetPermissionId,
      transferOwnership: true,
      sendNotificationEmail: true,
      resource: {
        role: 'owner'
      }
    });

    console.log(res.data);
    console.log(`已将所有权转移给 ${newOwnerEmail}`);
    return res.data;
  } catch (err) {
    console.log(`无法将所有权转移给 ${newOwnerEmail}`);
    console.log(err);
    throw err;
  }
}

额外注意事项 #

• 确保授权客户端拥有https://www.googleapis.com/auth/drive的完整权限（只读权限无法完成所有权转移）
• 个人Google账户之间转移所有权时，目标用户必须拥有Google账号，且不能是共享驱动器中的文件（共享驱动器所有权属于域管理员，无法转移给个人）
• Google Workspace账户需确认域管理员是否允许成员转移文件所有权

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