使用URLFetchApp导出Google Sheets指定工作表为PDF时遇HTTP 401错误

核心原因：权限范围不足 #

你遇到的HTTP 401错误，本质是当前脚本配置的权限范围无法覆盖Google Sheets导出PDF所需的Drive接口访问权限。

• 你配置的spreadsheets.currentonly权限仅允许操作绑定脚本的当前工作表内容，但导出PDF的请求实际调用的是Google Drive的文件导出接口，该接口需要Drive相关权限才能访问。
• 浏览器直接访问能成功，是因为浏览器会话继承了你账号的完整Drive权限，而脚本的OAuth Token仅包含你配置的有限权限，因此被拒绝访问。

具体修复步骤 #

1. 补充Drive相关权限范围 #

在脚本的appsscript.json文件中，添加以下权限之一（遵循最小权限原则选择）：

• https://www.googleapis.com/auth/drive.file：仅允许访问脚本创建或已授权的文件（推荐）
• https://www.googleapis.com/auth/drive.readonly：允许只读访问所有Drive文件

修改后的oauthScopes数组示例：

"oauthScopes": [
  "https://www.googleapis.com/auth/script.external_request",
  "https://www.googleapis.com/auth/script.send_mail",
  "https://www.googleapis.com/auth/spreadsheets.currentonly",
  "https://www.googleapis.com/auth/drive.file"
]

2. 重新授权脚本 #

修改权限后必须重新授权：

• 打开脚本编辑器，点击右上角「运行」按钮触发授权流程
• 在弹出的权限请求窗口中，确认并授予新权限

3. 验证URL构造正确性 #

确保导出PDF的URL参数完全正确，避免因参数错误引发权限误判：

• 确认文件ID是当前工作簿的正确ID（可通过SpreadsheetApp.getActiveSpreadsheet().getId()获取）
• 确认gid参数是目标工作表的ID（可通过sheet.getSheetId()获取）
• 确保URL包含export=pdf核心参数，示例格式：

https://docs.google.com/spreadsheets/d/{FILE_ID}/export?exportFormat=pdf&gid={SHEET_ID}

4. 确认Token获取与请求头设置 #

确保使用ScriptApp.getOAuthToken()获取正确的OAuth Token，并在URLFetchApp请求中正确设置请求头：

const token = ScriptApp.getOAuthToken();
const response = UrlFetchApp.fetch(exportUrl, {
  headers: {
    'Authorization': `Bearer ${token}`
  }
});

额外排查点 #

若修复后仍报错，检查以下内容：

• 目标工作表是否存在，且当前脚本有权访问
• 导出URL中是否包含冲突参数（如access_token，会覆盖你携带的Token导致权限验证失败）

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