用途:通过 gplay CLI 批量创建或更新 Google Play 订阅的本地化显示名称、描述与权益(benefits),覆盖 Google Play 支持的全部语言区域,替代在 Play Console 中逐语言手动编辑。
前提条件:已配置认证(gplay auth login 或 GPLAY_SERVICE_ACCOUNT 环境变量);已知包名(--package 或 GPLAY_PACKAGE);订阅商品已创建(先用 gplay subscriptions create);服务账号具备“编辑和管理您的应用”权限。
主要能力:列出与查看订阅(gplay subscriptions list / get);用 JSON 文件一次性写入多语言 listings;仅更新 listings 字段(--update-mask listings),避免覆盖基础方案与定价;支持导出、翻译、再导入的流程;可批量处理应用内全部订阅;创建订阅时可同时写入本地化 listings 与基础方案。
使用方式:先列出订阅并查看当前 listings,准备多语言 JSON(listings 对象按 locale 键控,含 title、benefits、description),再执行 gplay subscriptions update --package com.example.app --product-id premium_monthly --json @subscription-listings.json --update-mask listings,最后用 get 验证。批量脚本可遍历 subscriptions list 的 productId 逐个更新。
限制与注意:订阅 listings 按订阅原子更新,一次调用设置所有语言;--update-mask 很关键,否则可能覆盖基础方案与定价;标题最长 55 字符,权益最多 4 项,描述最长 80 字符;offerTags 在 Google Play API 中不区分语言区域,是开发者自定义标识,面向用户的文案需在应用代码中本地化;列表命令建议加 --paginate,检查 JSON 时用 --pretty;运行前用 --help 确认参数。
适用场景:需要为多语言市场快速补齐或统一订阅展示文案的 Android 应用团队。