使用drive.file scope的Google Docs插件无法获取activeDocument的求助

问题背景 #

• 开发的Google Docs插件通过菜单选项触发文本高亮功能，核心依赖DocumentApp.getActiveDocument()修改当前打开的文档
• 使用窄权限范围https://www.googleapis.com/auth/drive.file时，DocumentApp.getActiveDocument()调用失败——插件无法识别触发自身的当前文档，该文档不在权限允许的可访问文件列表内
• Google官方建议用Drive Picker解决，但这会强制用户手动查找正在编辑的文档，体验极差
• 改用扩展权限https://www.googleapis.com/auth/documents能实现无缝功能，但该权限属于敏感权限，需要年度审核，平白增加合规负担

权限限制的原因 #

Google设计drive.file权限的核心逻辑是最小权限原则：这个权限只允许插件访问用户明确主动授权的文件——比如用户通过Drive Picker选择的文件，或者插件自己创建的文件。而菜单触发时的当前文档，用户没有通过显式操作授权插件访问，所以不在权限覆盖范围内。本质是为了防止插件在用户不知情的情况下访问任意文档，保护用户数据隐私。

无需完整Docs权限的替代方案 #

1. 首次使用时关联当前文档 #

在插件第一次安装或授权后，引导用户点击一个临时的"关联当前文档"按钮，通过代码将当前文档加入插件的授权列表：

• 用ScriptApp.getOAuthToken()获取授权令牌
• 调用Drive API的permissions.create接口，把插件的服务账号添加到当前文档的权限列表中（这个操作只需要drive.file权限）
  完成这一步后，后续菜单触发时就能直接访问该文档，无需用户再手动选择。

2. 菜单创建时传递文档ID #

虽然DocumentApp.getActiveDocument()在drive.file权限下无法调用，但如果插件是在用户打开文档后加载的，可以在创建自定义菜单时提前获取当前文档ID，把它作为参数传递给菜单触发的函数：

function onOpen() {
  const docId = DocumentApp.getActiveDocument().getId();
  DocumentApp.getUi().createMenu('我的插件')
    .addItem('高亮文本', `highlightText('${docId}')`)
    .addToUi();
}

function highlightText(docId) {
  const doc = DocumentApp.openById(docId);
  // 执行高亮逻辑
}

注意：这个方法只在插件首次加载时能获取到ID，如果用户是第一次打开文档且未授权，可能会失败，需要结合第一种方案的首次授权流程。

3. 申请Marketplace权限豁免 #

如果插件是发布到Google Workspace Marketplace的正式插件，可以申请受限范围豁免。不过这个流程要求严格，需要提交详细的功能说明，证明插件必须访问当前文档且没有其他替代方案，适合有一定用户规模的插件。

总结 #

如果不想承担敏感权限的年度审核成本，优先选第一种方案：首次使用时引导用户完成当前文档的授权，后续就能无缝使用功能。既符合最小权限原则，又能保证用户体验。

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