使用Google Picker API的DocsView时出现500错误求助

问题重现 #

使用Google Picker API构建文件夹选择视图时出现500服务器错误，错误提示：

500. That's an error. There was an error. Please try again later. That's all we know.

相关代码：

var builder = new google.picker.PickerBuilder();
builder.setOAuthToken(authToken);
builder.setDeveloperKey(developerKey);
builder.setCallback(pickerCallback);
builder.setSize(575, 400);
builder.hideTitleBar();
var folderView = new google.picker.DocsView(google.picker.ViewId.FOLDERS);
folderView.setSelectFolderEnabled('true');
builder.addView(folderView);
picker = builder.build();

切换到DOCS、DOCS_IMAGES_AND_VIDEOS等其他视图时功能正常，且该功能此前运行稳定，近期突然出现故障。

排查与解决步骤 #

• 修正参数类型错误：setSelectFolderEnabled方法要求传入布尔值，而非字符串。代码中'true'带引号属于错误写法，改为：

  folderView.setSelectFolderEnabled(true);
  

  字符串类型参数可能导致API后端解析异常，触发500错误。

• 验证OAuth权限范围：确认当前authToken包含足够的Drive权限，至少需要https://www.googleapis.com/auth/drive.metadata.readonly（只读访问文件夹元数据）或https://www.googleapis.com/auth/drive（完整权限）。部分视图权限要求较低，不会暴露权限不足问题，但文件夹视图需要明确的权限支持。

• 检查项目配置与配额：

  1. 登录Google Cloud控制台，确认Picker API已启用；
  2. 核对开发者密钥与当前项目的一致性；
  3. 查看API配额使用情况，若Drive相关API配额耗尽，也可能触发500错误（部分场景下不会返回明确的配额超限提示）。

• 确认Google服务状态：检查Google Workspace官方服务状态，确认Drive及Picker API是否存在临时维护或故障。近期突发问题大概率和服务端波动有关。

• 调试请求细节：打开浏览器开发者工具的「网络」面板，捕获Picker API的请求，查看响应的详细信息（包括响应头、错误正文），可能得到比通用500提示更具体的故障原因。

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