Python调用Google Drive API导出Docs为PDF时如何设置图片质量

你当前调用的默认export_media方法没有指定PDF导出的画质配置，Google Drive默认采用72DPI网页适配分辨率、MEDIUM档位图片压缩率导出PDF，文档内嵌入的位图会被强制压缩，最终导出的文件图片清晰度差。

方案1：接口指定高画质导出参数（无额外依赖，优先选用） #

export_media是封装好的简化方法，不支持传自定义导出配置，需要改用原生files().export()方法构造请求，传入pdfOptions指定最高图片质量、打印级300DPI分辨率，修改后的代码如下：

service = build('drive', 'v3', credentials=creds)
file_id = real_file_id

# 构造带高画质配置的导出请求
request = service.files().export(
    fileId=file_id,
    mimeType='application/pdf',
    body={
        "pdfOptions": {
            "imageQuality": "HIGH",
            "dpi": 300,
            "useDocumentPageSize": True
        }
    }
)

file = io.BytesIO()
downloader = MediaIoBaseDownload(file, request)
done = False
while done is False:
    status, done = downloader.next_chunk()
    print(f'Download {int(status.progress() * 100)}.')

说明：该配置不会对低于300DPI的原图做强行插值放大，仅会关闭导出流程中的额外压缩，保留图片原有最高清晰度。

方案2：本地转码实现100%画质可控 #

如果接口导出的画质仍达不到要求（比如需要完全无压缩的原图嵌入效果），可以走本地转码流程，完全避开Google服务端的压缩逻辑：

1. 先调用接口将文档导出为DOCX格式，该格式导出时不会压缩文档内存储的原图资源
2. 本地使用pypandoc、docx2pdf或LibreOffice命令行工具将DOCX转成PDF，转码时手动指定图片质量100%、目标DPI即可。

导出DOCX的核心代码片段：

request = service.files().export_media(
    fileId=file_id,
    mimeType='application/vnd.openxmlformats-officedocument.wordprocessingml.document'
)
# 下载得到docx文件后，自行调用本地工具转PDF即可

• 往Google Docs插入图片时尽量使用原始分辨率的文件，不要提前压缩，Google Docs会存储原图副本，只要导出参数正确就能拿到清晰结果
• 不要尝试给export_media方法强行加参数，该简化方法内部固定了默认导出配置，传自定义参数不会生效

内容的提问来源于stack exchange，提问作者F. Upai