求助：Apps Script中ScriptApp.getOAuthToken()返回null，Google文件选择器无法正常运行

我之前也踩过这个坑，折腾了好一会儿才搞定，给你梳理几个最可能的原因和解决步骤：

1. 检查OAuth权限范围是否配置完整 #

ScriptApp.getOAuthToken()返回null最常见的原因是脚本缺少必要的OAuth权限范围。你需要确保appsscript.json清单文件里包含以下关键范围：

• https://www.googleapis.com/auth/drive.readonly（或更宽的https://www.googleapis.com/auth/drive，根据你的需求）
• https://www.googleapis.com/auth/script.external_request（用于外部请求，Picker需要这个）

操作步骤：

• 在Apps Script编辑器右上角点击「设置」图标，勾选「显示appsscript.json清单文件」
• 打开appsscript.json，找到oauthScopes数组，补充缺失的范围，示例如下：

  "oauthScopes": [
    "https://www.googleapis.com/auth/drive.readonly",
    "https://www.googleapis.com/auth/script.external_request"
  ]
  

• 保存文件后，重新运行脚本，此时会提示你重新授权，务必完成授权流程。

2. 确认云项目的API和OAuth配置 #

虽然你已经启用了Google Picker API，但还是要再核对以下几点：

• 确保云控制台中你的项目确实启用了Google Picker API：进入云控制台，搜索该API，确认状态为「已启用」
• 检查OAuth同意屏幕配置：
  • 如果是外部测试应用，必须添加你的Google账号为测试用户
  • 如果是Workspace内部应用，确保你的账号属于允许的组织
• 确认Apps Script绑定的云项目是你配置的那个：在Apps Script编辑器的「项目设置」中，点击「云平台项目」的链接，验证是否跳转到你配置API的项目。

3. 避免在简单触发器中调用token #

简单触发器（比如onOpen、onEdit）是在无授权的受限模式下运行的，调用ScriptApp.getOAuthToken()必然返回null。解决办法：

• 将Picker初始化代码放在手动运行的函数中，比如showPicker()，手动触发运行
• 或者创建可安装触发器替代简单触发器：在Apps Script编辑器的「编辑」→「当前项目的触发器」中，添加一个可安装的onOpen触发器，这样运行时会携带授权信息。

4. 重置脚本授权缓存 #

有时候授权缓存会出现异常，导致token无法获取：

• 打开你的Google账号安全设置，找到「第三方应用访问权限」，找到你的Apps Script项目，点击「移除访问权限」
• 回到Apps Script编辑器，重新运行你的Picker函数，按照提示完成重新授权。

5. 检查Picker代码的细节 #

确保你的Picker初始化代码正确传递了token：

• 服务器端函数示例：

  function showPicker() {
    const token = ScriptApp.getOAuthToken();
    if (!token) throw new Error("无法获取OAuth令牌，请检查授权设置");
    
    const html = HtmlService.createHtmlOutputFromFile('Picker')
      .setWidth(600)
      .setHeight(425)
      .setSandboxMode(HtmlService.SandboxMode.IFRAME);
    
    SpreadsheetApp.getUi().showModalDialog(html, '选择文件');
  }
  

• 客户端HTML代码示例（要正确嵌入token）：

  <script src="https://apis.google.com/js/api.js"></script>
  <script>
    function initPicker() {
      const token = '<?= ScriptApp.getOAuthToken() ?>';
      const picker = new google.picker.PickerBuilder()
        .addView(google.picker.ViewId.DOCUMENTS)
        .setOAuthToken(token)
        .setDeveloperKey('你的云项目浏览器API密钥')
        .setCallback(pickerCallback)
        .build();
      picker.setVisible(true);
    }
    
    function pickerCallback(data) {
      // 处理选择结果
    }
    
    google.load('picker', '1', {callback: initPicker});
  </script>
  

注意：你的浏览器API密钥需要在云控制台中创建，并确保密钥允许Apps Script的域名访问（测试阶段可以暂时设置为允许所有域名）。

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