Google Sheets脚本权限行为变化及getValue、clear操作异常问询

该现象是Google Workspace 2024年上半年针对受保护Google Sheets工作表的GAS权限校验逻辑做的灰度调整，不属于临时故障。本次调整修改了GAS调用工作表范围操作时的权限校验优先级：此前校验逻辑仅验证目标单元格的实际权限，调整后部分方法会优先校验整张工作表的保护状态，普通用户无整张表编辑权限时，即使目标单元格属于放开的可编辑范围，也会触发权限报错。
相关调整属于灰度放量阶段，暂未对外发布公开的变更公告，目前仅覆盖部分区域的Google Workspace用户。

方法差异原因 #

clear({contents: true})和clearContent()的底层实现逻辑存在差异：

• clear(options)属于复合功能的批量操作方法，本次调整后被纳入工作表级权限校验范围，会先校验用户是否拥有整张工作表的编辑权限
• clearContent()属于针对单元格内容的单一功能方法，目前仍沿用原有单元格级权限校验逻辑，仅验证目标单元格的编辑权限，因此替换方法后可以正常运行

此前出现的getValue()报错误判，是新版Apps Script编辑器行号显示错位的已知问题导致，getValue()等只读类方法的权限校验逻辑未发生调整，不会触发权限报错。

• 替换所有clear(options)复合清除方法为对应单一功能方法：清除内容用clearContent()，清除格式用clearFormat()，清除备注用clearNote()，避免触发工作表级权限校验
• 调整工作表保护规则：不使用「保护整张工作表」的规则，改为选中整张工作表后使用「保护特定范围」规则，再将允许普通用户编辑的单元格添加到例外范围，该规则下的权限校验适配更完善，可避免误判
• 无需记录操作人身份的场景，可将脚本部署为以所有者身份执行，直接跳过普通用户的权限校验环节

疑点解释 #

将报错代码复制到新脚本可正常运行，是因为本次调整为灰度放量模式，同一账号下不同的表格、脚本资源的放量进度不同，新创建的资源暂未被纳入灰度覆盖范围，后续灰度全量后也可能触发同类报错。

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