Google Play 开发者 API

概览

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 率、唤醒和唤醒锁定问题以及错误堆栈跟踪。

最佳实践

  • 此版本的 Reporting API 默认限制为每秒 10 次查询。您可以在 Google Cloud 控制台的配额部分查看您的配额使用情况。如果您需要超出此限制,可以使用此表单提交配额请求。

回复评价 API

借助 回复评价 API,您可以查看用户对应用的反馈并回复这些反馈。您可以使用此 API 在您现有的客户支持工具包(例如 CRM 系统)中直接与用户互动。

回复评价 API 仅允许您访问应用的正式版反馈。如果您想查看应用的 Alpha 或 Beta 版反馈,请改用 Google Play 管理中心。另外请注意,此 API 仅显示包含评论的评价。如果用户对您的应用评分但未提供评论,则无法通过 API 访问其反馈。

权限 API

权限 API 使开发者能够自动管理 Play 管理中心内的权限。这可让您灵活控制谁有权访问您的开发者帐号,无需人工参与。

借助权限 API,您可以执行以下管理功能:

  • 当用户离开公司时,移除他们的访问权限。
  • 当用户加入相关团队时,授予其对应用的访问权限。

已作废购买交易 API

借助 已作废购买交易 API,您可以获取与用户已作废购买交易相关的订单列表。您可以使用此列表中的信息来实现撤销系统,从而阻止用户访问这些订单中的产品。

此 API 适用于一次性应用内订单和应用订阅。

购买交易可通过以下方式作废:

  • 用户为其订单申请退款。
  • 用户取消订单。
  • 订单被退款(charged back)。
  • 开发者取消或退款订单。注意:已作废购买交易 API 中仅显示已撤销的订单。如果开发者退款时未设置撤销选项,则订单不会显示在 API 中。
  • Google 取消或退款订单。

通过使用此 API,您可以帮助为应用的所有用户创建更平衡、更公平的体验,尤其是当您的应用是游戏时。