调用Google Drive Export API通过浏览器下载文件时转换不支持报错

问题根因 #

你收到的The requested conversion is not supported报错，以及无法正常导出文件的问题，由以下几个错误导致：

1. files.export接口不支持将Google Workspace文档导出为其原生格式application/vnd.google-apps.document，必须转换为第三方标准格式
2. 代码内权限范围配置错误
3. 接口请求参数名拼写错误

解决方案 #

1. 配置正确的导出MIME类型

Google Docs类型的文件支持导出为以下常用格式，按需选择即可：

• 导出为Word文档：application/vnd.openxmlformats-officedocument.wordprocessingml.document
• 导出为PDF：application/pdf
• 导出为纯文本：text/plain
• 导出为HTML：text/html

2. 修正代码错误

• 权限范围错误：你代码中填写的scope为https://www.googleapis.com/auth/drive.drive，多了冗余的.drive后缀，正确的全量Drive权限值为https://www.googleapis.com/auth/drive，仅需下载的话可以使用权限范围更小的https://www.googleapis.com/auth/drive.readonly
• 参数名拼写错误：files.export接口的文件ID参数名为fileId（第二个字母d为小写），你代码中写的fileID（第二个字母D为大写）会导致接口无法正确识别文件ID

3. 补充二进制内容下载逻辑

gapi接口返回的二进制内容需要手动处理为可下载的文件，修正后的核心代码参考如下：

var developerKey = '替换为你的API Key'
var clientId = '替换为你的OAuth Client ID'
var scope = 'https://www.googleapis.com/auth/drive.readonly'
// 改为导出为Word格式
const exportMimeType = 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
const fileID = '1O2ORp9te3FzqTFZkPLGNGvAnzcKBhdGZ-lu8TgABPrY'

function load() {
  gapi.load('client:auth2', () => {
    gapi.client.init({
      clientId,
      scope,
      apiKey: developerKey,
      discoveryDocs: ['https://www.googleapis.com/discovery/v1/apis/drive/v3/rest'],
    }).then(() => {
      gapi.auth2.getAuthInstance().signIn().then(() => {
        gapi.client.drive.files.export({
          fileId: fileID,
          mimeType: exportMimeType,
        }).then(res => {
          // 生成下载文件
          const blob = new Blob([res.body], { type: exportMimeType })
          const downloadUrl = URL.createObjectURL(blob)
          const a = document.createElement('a')
          a.href = downloadUrl
          a.download = '测试文档.docx'
          document.body.appendChild(a)
          a.click()
          document.body.removeChild(a)
          URL.revokeObjectURL(downloadUrl)
        }).catch(error => console.error('导出错误：', error))
      })
    }, error => console.error('初始化错误：', error))
  })
}

调试思路 #

• 先在API Explorer中把导出mimeType替换为支持的格式，确认接口可以正常返回内容，排除文件权限问题
• 检查OAuth授权弹窗中是否已经授予了Drive访问权限，授权后可以调用files.get接口确认文件ID正确、账号有访问权限
• 查看浏览器控制台的网络请求详情，确认请求参数、返回结果符合预期

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