用途:通过 Android Publisher API 程序化管理 Google Play 一次性商品与订阅目录,替代或补充 Play Console 手动操作,适合产品数量大、需要批量同步区域定价的场景。
主要能力:支持 monetization.onetimeproducts 与 monetization.subscriptions 两组端点的创建、定向 patch、batchUpdate 批量更新、list 列表、delete 删除;订阅还支持 basePlans.activate 激活、deactivate 停用、migratePrices 价格迁移。可按目录规模选择 UI、batchUpdate 或分批限速策略,并支持本地先做对账差异(远端缺失、不一致、本地缺失)再写入。
必要用法:服务账号需在 Play Console 持有 Financial 权限,否则相关调用返回 403;API 创建的基础计划初始为 DRAFT,须调用 activate 后用户才能购买;patch 区域定价字段时应携带 regionsVersion;批量请求每批约 100 个,每个 batch 计一次配额;区域定价走 batchUpdate 加 latency tolerant 模式;对已有旧价格订阅者用 migratePrices 迁移。遇到 HTTP 429 rateLimitExceeded 应指数退避重试。
限制:订阅仅在从未激活任何基础计划时才能删除,激活后停用即终态;旧版 inappproducts 与新版迁移后互斥;一次性商品建议下架而非删除以保留恢复流程;大规模对账建议设置变更阈值,超限则失败并要求人工复核。
分类:编程与开发。