概览
Google Play 管理中心提供了一套基于 REST 的 Web 服务 API,可让您直接对应用执行发布、报告和其他应用管理功能。
并非所有开发者都需要使用这些开发者 API — 在大多数情况下,您可以继续使用 Google Play 管理中心直接管理您的应用。但是,如果您需要管理大量的 APK,或需要跟踪用户购买和订阅,您可能会发现这些 API 非常有用。
包含哪些内容
Google Play 开发者 API 可让您专注于设计和开发应用,同时减少管理发布的时间和精力,即使您扩展到新市场也是如此。
Google Play 管理中心包含一套可用于管理应用的 API
- 借助 发布 API,您可以上传和发布应用,并执行其他与发布相关的任务。
- 借助 订阅和应用内购买 API,您可以管理应用内购买和订阅。(此 API 以前称为“购买状态 API”。)
- 借助 报告 API,您可以从 Android vitals 中检索有关应用质量的信息。
- 借助 回复评价 API,您可以检索并回复对您应用的评价。
- 借助 权限 API,您可以在 Play 管理中心内实现权限管理的自动化。
- 借助 Play 游戏服务管理 API,您可以发出 REST 调用,以编程方式控制 Google Play 游戏服务功能的基础元数据。
- 借助 已作废购买交易 API,您可以获取与用户已作废购买交易相关的订单列表。
开始使用
要开始使用 Google Play 开发者 API,请参阅入门文档。
发布 API
借助 发布 API,您可以自动执行与应用分发相关的常见任务。此 API 提供了与开发者通过 Play 管理中心可用的功能类似的功能,例如:
- 上传新版本的应用
- 发布应用,方法是将 APK 分配到各种渠道(Alpha 版、Beta 版、分阶段发布或正式版)
- 创建和修改 Google Play 商店商品详情,包括本地化文本、图形和多设备屏幕截图
这些任务使用编辑功能执行,该功能采用事务性方法进行更改。这允许您将多个更改捆绑到一个草稿编辑中,然后一次性提交所有更改。(在提交编辑之前,任何更改都不会生效。)
最佳实践
- 限制应用更新次数。不要每天发布一次以上的 Alpha 或 Beta 更新(正式版应用的更新频率应更低)。每次更新都会花费用户的时间和可能的金钱。如果您更新过于频繁,用户可能会开始忽略更新,甚至卸载产品。
订阅和应用内购买 API
借助 订阅和应用内购买 API,您可以管理应用的应用内商品和订阅目录。此外,借助订阅和应用内购买 API,您可以使用标准的 GET
请求快速检索任何购买交易的详细信息。
在请求中,您需要提供有关购买交易的信息 — 应用软件包名称、购买或订阅 ID 以及购买令牌。服务器会返回一个 JSON 对象,其中包含相关的购买详细信息、订单状态、开发者负载和其他信息。
您可以通过多种方式使用此 API,例如用于报告和对账单个订单,以及验证购买交易和订阅到期。您还可以使用此 API 了解已取消的订单,并确认应用内商品是否已被消耗,包括在取消之前是否已被消耗。
最佳实践
- 在您的服务器上存储订阅信息,以避免进行不必要的 API 调用。当您的应用需要验证订阅时,您应该依赖服务器上缓存的信息,而不是重复向 Google 发出 API 调用。
- 在以下两种情况下,您的安全服务器应使用 Google Play 开发者 API 获取订阅信息:
- 您的服务器收到之前未曾见过的新的购买令牌。
- 您的服务器收到实时开发者通知 (RTDN),这表示您需要使用购买令牌来获取新的订阅信息。
- 不要定期轮询 API 来获取订阅状态。例如,不要每天调用 API 来检查每个订阅。
- 由于您在订阅到期或续订时会收到 RTDN,因此您无需根据预定的到期时间安排 API 调用。
报告 API
对于希望在 Play 管理中心数据之上构建自动化工作流的开发者,或使用 Play 管理中心数据进行内部业务报告和分析(可能与其他数据集一起使用)的开发者,可以使用 报告 API。此 API 允许您以编程方式访问应用级别数据和指标,用于内部报告、分析和自动化。
报告 API 提供对 Android vitals 数据的访问权限,包括崩溃率、ANR 率、唤醒和唤醒锁定问题以及错误堆栈跟踪。
最佳实践
回复评价 API
借助 回复评价 API,您可以查看用户对应用的反馈并回复这些反馈。您可以使用此 API 在您现有的客户支持工具包(例如 CRM 系统)中直接与用户互动。
回复评价 API 仅允许您访问应用的正式版反馈。如果您想查看应用的 Alpha 或 Beta 版反馈,请改用 Google Play 管理中心。另外请注意,此 API 仅显示包含评论的评价。如果用户对您的应用评分但未提供评论,则无法通过 API 访问其反馈。
权限 API
权限 API 使开发者能够自动管理 Play 管理中心内的权限。这可让您灵活控制谁有权访问您的开发者帐号,无需人工参与。
借助权限 API,您可以执行以下管理功能:
- 当用户离开公司时,移除他们的访问权限。
- 当用户加入相关团队时,授予其对应用的访问权限。
已作废购买交易 API
借助 已作废购买交易 API,您可以获取与用户已作废购买交易相关的订单列表。您可以使用此列表中的信息来实现撤销系统,从而阻止用户访问这些订单中的产品。
此 API 适用于一次性应用内订单和应用订阅。
购买交易可通过以下方式作废:
- 用户为其订单申请退款。
- 用户取消订单。
- 订单被退款(charged back)。
- 开发者取消或退款订单。注意:已作废购买交易 API 中仅显示已撤销的订单。如果开发者退款时未设置撤销选项,则订单不会显示在 API 中。
- Google 取消或退款订单。
通过使用此 API,您可以帮助为应用的所有用户创建更平衡、更公平的体验,尤其是当您的应用是游戏时。