本技能用于 Android 应用接入 Google Play 计费前的环境搭建阶段,适用于尚未配置 Play Console、商品、API 访问或 RTDN 的场景,也用于排查「此版本的应用未配置通过 Google Play 结算」、Google Play Developer API 返回 403、收不到 Pub/Sub 测试通知等问题。目标环境包含:已验证的 Play 开发者账号、关联的付款资料、内部测试轨道构建、至少一个已激活商品、具备相应 Play Console 角色的服务账号,以及接收 RTDN 的 Pub/Sub 主题。
主要步骤:注册并验证 Play 开发者账号;创建并验证 Google Payments 资料;在 build.gradle.kts 中加入 Play Billing Library 9.x 依赖(PBL 9 要求 minSdk 23、compileSdk/targetSdk 35、androidx.core 1.9 以上),上传已签名构建到内部测试轨道;创建商品或订阅并激活;在 GCP 创建服务账号并在 Play Console 单独授予最小角色(如查看财务数据、管理订单与订阅);创建 Pub/Sub 主题,为 google-play-developer-notifications@system.gserviceaccount.com 授予 Pub/Sub Publisher;创建推送或拉取订阅并配置死信主题;在 Play Console 的 Monetize > Monetization setup 中填写完整主题名 projects/your-project-id/topics/... 并发送测试通知。
限制与注意:组织账号验证可能耗时约两周;Payments 资料未验证前无法创建付费商品;Play Console 权限与 GCP IAM 相互独立;商品 ID 激活后不可复用;新激活商品可能有传播延迟;Pub/Sub 默认无限重试,需设置最大投递次数;服务账号 JSON 密钥不应提交或嵌入客户端。其他未在资料中说明的事项暂未提供。