Google Apps Script Classroom管理表格插件多账号权限错误问题

问题根源分析 #

• OAuth权限范围声明不全：直接运行脚本时会动态请求权限，但插件部署需预先声明所有必要权限。若Code.gs用到的API权限未在插件清单或云项目中正确配置，其他用户调用时会触发权限拒绝。
• OAuth同意屏幕配置错误：组织内部署的插件需将同意屏幕设置为“内部”，且敏感权限（如Admin SDK相关范围）需完成组织内审批，否则普通用户无法获取权限。
• 插件执行权限设置不当：部署时若选择“仅我自己”作为执行身份，其他用户运行需要API调用的功能时会因权限不足失败。
• 表格模板与插件权限上下文脱节：创建的表格模板若未继承插件的OAuth权限上下文，按钮绑定的脚本会以表格独立权限运行，无法调用需要授权的API。

解决步骤 #

1. 补全插件权限范围声明 #

• 打开Apps Script项目，点击菜单栏「查看」→「显示清单文件」，打开appsscript.json。
• 在oauthScopes字段中添加Code.gs用到的所有API权限范围，示例如下：

  "oauthScopes": [
    "https://www.googleapis.com/auth/classroom.courses",
    "https://www.googleapis.com/auth/classroom.rosters",
    "https://www.googleapis.com/auth/drive.file",
    "https://www.googleapis.com/auth/spreadsheets",
    "https://www.googleapis.com/auth/admin.directory.user.readonly"
  ]
  

  需根据实际功能调整权限范围（如只读操作对应readonly后缀），修改后重新部署插件。

2. 修正Google Cloud项目OAuth同意屏幕配置 #

• 进入插件关联的Google Cloud项目，打开「API和服务」→「OAuth同意屏幕」。
• 确认用户类型为「内部」，已授权域名包含组织域名。
• 检查「范围」列表，确保appsscript.json中声明的权限全部添加，敏感权限需完成组织内审批流程（若有）。

3. 调整插件执行权限设置 #

• 重新部署插件时，在部署类型选择「编辑器附加组件」后，将「执行权限」设置为「以用户身份运行」。
• 若插件需调用Admin SDK等管理员专属API，需确保使用插件的用户为组织内管理员，并在云项目中为其授予对应API的访问角色。

4. 确保表格模板与插件权限关联 #

• 检查Creating Spreadsheet.gs的表格创建逻辑，确保通过插件上下文创建表格（如使用SpreadsheetApp.create()时，依赖插件的OAuth权限传递）。
• 避免在表格模板中绑定独立脚本，需通过插件自定义菜单或按钮直接调用Code.gs中的函数，确保权限上下文为插件的OAuth授权。

5. 重置用户授权状态 #

• 让测试用户在Google账号「安全」→「第三方应用访问权限」中移除该插件的权限，重新打开插件并完成完整授权流程，排除误拒权限导致的问题。

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