如何通过脚本向Google Play Books上传电子书

Google 官方公开的 Books API 仅提供书籍元数据查询、书架管理类能力，确实没有开放个人自有电子书上传的公开接口。实现自动化上传不需要完全依赖Chrome CDP类工具模拟网页操作，存在客户端/网页端实际在用的非公开接口可以直接调用，两种方案都能跑通，按需选择即可。

两种实现方案说明 #

• 非公开API直传方案
  这个是Google Play Books网页端、安卓端实际调用的内部上传接口，走标准OAuth2.0鉴权，个人使用稳定性足够：
  • 鉴权时不能只用公开API的https://www.googleapis.com/auth/books权限scope，要和网页端保持一致，加上上传操作需要的对应权限，否则会报403错误
  • 上传流程和Google其他云服务的分片上传逻辑一致：先调用初始化接口创建上传会话拿到专属上传地址，支持断点续传，再将epub/pdf文件推送到该地址，最后调用完成接口触发云端书籍解析、归入书架
  • 支持的文件规格和官方客户端完全一致：epub、pdf格式，单文件最大2G，上传后自动同步到账号下所有登录端的书架
    注意：该接口属于未公开的内部接口，Google随时可能调整参数、鉴权规则，没有官方稳定性承诺，仅适合个人小体量使用，不要基于它做对外服务，短时间高频调用还可能触发账号风控。
• CDP/浏览器自动化方案
  这是长期稳定性最高的方案，完全模拟真人操作，不需要逆向接口逻辑：
  • 用Playwright、Puppeteer这类支持CDP的自动化工具即可，登录态可以持久化保存在本地，不需要每次操作都重新登录
  • 逻辑非常简单：打开Google Play Books网页端我的书架页面，触发原生文件选择器，传入本地电子书路径，等待页面弹出上传成功提示即可，不需要自己处理分片、鉴权续期、接口参数变动的问题
  • 缺点是依赖浏览器运行环境，上传速度比直传接口稍慢，不过无头模式下可以后台静默运行，不影响正常使用设备。

实现避坑 #

• 无论选哪种方案，不要短时间内批量上传上百本文件，很容易触发Google的账号安全校验，轻则要求重新验证身份，重则临时封禁上传权限
• 带DRM保护的电子书无法正常解析上传，就算传上去也不会出现在书架里
• Python技术栈的话，直传方案可以用google-api-python-client处理鉴权逻辑，自行补全上传流程代码即可；自动化方案直接用playwright的Python版本，几十行代码就能跑通
• NodeJS技术栈同理，直传用官方googleapis包处理鉴权，自动化选puppeteer或playwright都可以。

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