Google Drive API v3新授权账号导出文档图片转为Base64编码问题

1. 官方变更说明 #

目前Google并未公开发布针对该导出行为差异的专门文档。这类差异大概率是后端未提前公告的调整，或与新授权账号的关联OAuth应用状态、权限范围有关：

• 若新账号使用的是未经过Google验证的OAuth应用，可能会触发资源外链权限限制，导致图片自动转为Base64嵌入；
• 部分新账号的隐私设置或Drive资源访问策略，可能禁止生成可公开访问的图片外链，进而触发Base64替代逻辑。

2. 无需大规模重构恢复旧格式的可行方案 #

（1）完成OAuth应用验证 #

如果新账号关联的OAuth应用处于「未验证」状态，按照Google的OAuth应用验证流程提交审核，通过后大概率会恢复图片外链的导出形式。

（2）检查并调整授权权限 #

确保授权时请求了足够的Drive读写权限，例如在OAuth scopes中包含https://www.googleapis.com/auth/drive.readonly或https://www.googleapis.com/auth/drive.file（按需选择）。部分新账号的权限范围过窄可能导致无法生成外链。

（3）添加API请求参数尝试 #

在export_file调用中补充supports_all_drives: true参数（若文档存储在共享驱动器中），或尝试指定alt: 'media'参数（需测试兼容性）：

html = drive.export_file(
  external_id,
  'text/html',
  supports_all_drives: true
)

（4）轻量代码转换（无需重构核心逻辑） #

如果上述方法无效，可以在导出HTML后添加一段轻量处理逻辑，将Base64图片转为Drive外链：

1. 解析HTML中的data:image格式img标签；
2. 将Base64内容解码为二进制文件，上传到Google Drive并设置「公开访问权限」；
3. 替换img标签的src为新上传文件的外链URL。

这段处理逻辑仅需在现有导出代码后追加，无需修改核心的API调用逻辑。

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