如何在Google Apps Script中使用Google Sheets API且无需宽泛授权？

核心结论：容器绑定脚本完全可以使用https://www.googleapis.com/auth/spreadsheets.currentonly这一窄权限调用Google Sheets API，无需依赖宽泛的https://www.googleapis.com/auth/spreadsheets权限，具体操作如下：

• 确认脚本类型：必须是与目标表格绑定的容器脚本，currentonly权限仅授权访问脚本所属的这张表格，独立脚本无法使用该权限。

• 配置appsscript.json：
  直接在脚本的appsscript.json文件中指定窄权限：

  "oauthScopes": [
    "https://www.googleapis.com/auth/spreadsheets.currentonly"
  ]
  

  无需添加其他宽泛权限，保存后重新授权脚本。

• API调用规范：
  调用Sheets API时，仅针对当前绑定表格操作。例如通过SpreadsheetApp.getActiveSpreadsheet().getId()获取当前表格ID，传入API请求中，禁止访问其他表格资源，否则会触发权限不足错误。

• 权限验证：
  重新授权后，用户看到的权限提示会是"仅访问您使用此应用的Google表格"，而非"访问所有Google表格"，符合最小权限原则。

常见误区说明 #

部分示例教程未区分容器绑定脚本与独立脚本的权限差异：独立脚本因需访问任意表格，必须使用spreadsheets权限；但容器绑定脚本依托当前表格上下文，完全适配currentonly的窄权限范围。

权限错误排查 #

若出现权限不足报错，可从以下方向排查：

1. 确认脚本是容器绑定类型，而非独立脚本。
2. 检查appsscript.json中是否仅保留currentonly权限，无残留的spreadsheets权限。
3. 验证API调用的目标表格ID为当前绑定表格的ID，无硬编码其他表格ID。

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