如何用Node.js将Google Drive表格权限设为RESTRICTED并指定用户访问

核心操作步骤 #

要实现将表格的公开访问权限改为RESTRICTED并仅允许指定用户访问，需要完成三个关键操作：

1. 清理文件现有的公开访问权限
2. 将文件权限级别设置为RESTRICTED
3. 为目标用户添加专属访问权限

完整代码实现 #

基于googleapis 49版本，确保已配置包含https://www.googleapis.com/auth/drive权限的授权客户端（OAuth2或服务账号均可）：

const { google } = require('googleapis');
// 假设auth已完成授权配置（OAuth2客户端或服务账号）
const drive = google.drive({ version: 'v3', auth });

async function setRestrictedPermission(spreadsheetId, targetUserEmail) {
  try {
    // 1. 查找并删除所有公开权限（anyoneWithLink类型）
    const permList = await drive.permissions.list({
      fileId: spreadsheetId,
      fields: 'permissions(id, type)'
    });
    const publicPerms = permList.data.permissions?.filter(perm => perm.type === 'anyone') || [];
    
    for (const perm of publicPerms) {
      await drive.permissions.delete({
        fileId: spreadsheetId,
        permissionId: perm.id
      });
    }

    // 2. 将文件权限设置为RESTRICTED
    await drive.files.update({
      fileId: spreadsheetId,
      requestBody: {
        permissionRestrictions: {
          restricted: true,
          allowFileDiscovery: false
        }
      }
    });

    // 3. 添加指定用户的访问权限（可调整role为reader/owner）
    await drive.permissions.create({
      fileId: spreadsheetId,
      requestBody: {
        type: 'user',
        role: 'writer', // writer=编辑权限，reader=只读权限
        emailAddress: targetUserEmail
      },
      sendNotificationEmail: false // 关闭Google自动通知，避免和你的邮件重复
    });

    console.log(`权限修改完成：表格已设为RESTRICTED，仅${targetUserEmail}可访问`);
  } catch (err) {
    console.error('权限修改失败:', err.message);
    throw err;
  }
}

// 调用示例：替换为你的表格ID和目标邮箱
// setRestrictedPermission('your-spreadsheet-id-here', 'user@example.com');

关键细节说明 #

• 权限范围要求：必须包含https://www.googleapis.com/auth/drive，该权限足够覆盖所有文件权限修改操作。
• 清理公开权限的必要性：若文件存在anyoneWithLink类型的权限，即使设置了RESTRICTED，公开访问仍可能生效，因此必须先删除。
• RESTRICTED参数解释：permissionRestrictions.restricted = true会关闭文件的通用访问权限，仅已添加的用户可访问；allowFileDiscovery = false可防止文件被Google搜索到。
• 用户权限调整：role参数可按需修改：
  • reader：仅允许查看表格
  • writer：允许编辑表格
  • owner：转移文件所有权（需注意账号限制）
• 通知开关：sendNotificationEmail设为false是因为你已自行发送邮件通知，避免重复推送。

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