Google Play Developer API

概览

Google Play 管理中心提供了一套基于 REST 的网络服务 API，让您可以直接为应用执行发布、报告生成和其他应用管理功能。

并非所有开发者都需要使用这些开发者 API；在大多数情况下，您可以继续通过 Google Play 管理中心直接管理应用。不过，如果您有大量 APK 需要管理，或者需要跟踪用户的购买交易和订阅，您可能会发现这些 API 非常有用。

包含的内容

借助 Google Play Developer API，您可以集中精力设计和开发应用，同时减少在版本管理上投入的时间和精力，即使在您将应用推向新市场时也能如此。

Google Play 管理中心包含一套可用于管理应用的 API：

与 Firebase 相关的初始操作

如需开始使用 Google Play Developer API，请参阅使用入门文档。

Publishing API

您可以通过 Publishing API 自动执行与应用分发相关的常见任务。这包括与 Play 管理中心为开发者提供的功能类似的功能，例如：

  • 上传应用的新版本
  • 通过将 APK 分配至各个轨道（Alpha 版、Beta 版、分阶段发布版本或正式版）来发布应用
  • 创建和修改 Google Play 商店中的商品详情，包括已本地化的文字和图形与多设备屏幕截图

系统使用修改功能执行这些任务，此功能采用事务型方式进行更改。这样，您就可以将多项更改绑定到一个草稿修改中，然后一次性提交所有更改。（只有提交修改后，这些更改才会生效。）

最佳实践

  • 限制应用更新的次数。发布 Alpha 版或 Beta 版更新的频率每天不要超过一次（正式版应用的更新频率应低于该频率）。每次更新都会消耗用户的时间，还可能花费他们的金钱。如果您更新的频率过于频繁，用户会开始忽略更新，甚至卸载产品。

Subscriptions and In-App Purchases API

利用 Subscriptions and In-App Purchases API，您可以管理应用的应用内商品和订阅目录。此外，利用 Subscriptions and In-App Purchases API，您还可以通过标准的 GET 请求快速检索任何购买交易的详情。

在该请求中，您需要提供购买交易的相关信息：应用软件包名称、购买或订阅 ID 及购买令牌。服务器通过 JSON 对象响应，此对象将说明关联的购买交易详情、订单状态、开发者载荷和其他信息。

您可以通过多种方式使用此 API，例如，使用它报告和协调各个订单，以及验证购买和订阅过期。您也可以使用此 API 来了解已取消的订单和确认应用内商品是否已经消耗，包括它们是否是先消耗然后又被取消。

最佳实践

  • 将订阅信息存储在您的服务器上，避免进行不必要的 API 调用。当您的应用需要验证订阅时，您应该依赖服务器上的缓存信息，而不是重复向 Google 发出 API 调用。
  • 在以下两种情况下，您的安全服务器应使用 Google Play Developer API 获取订阅信息：
    • 您的服务器收到了之前没有见过的新购买令牌。
    • 您的服务器收到一条实时开发者通知 (RTDN)，该通知指明您需要使用购买令牌来获取新的订阅信息。
  • 请勿通过定期轮询 API 来获取订阅状态。例如，不要每天调用 API 来检查每项订阅。
  • 由于您在订阅到期或续订时会收到 RTDN，因此无需根据预定的过期时间安排 API 调用。

Reporting API

Reporting API 适用于希望基于 Play 管理中心数据构建自动工作流的开发者，或使用 Play 管理中心数据（可能结合其他数据集）进行内部业务报告和分析的开发者。这样，您就能以编程方式访问应用级的数据和指标，以完成内部报告、分析和自动化。

通过 Reporting API，您可以访问 Android Vitals 数据，包括崩溃率、ANR 发生率、唤醒和唤醒锁定问题以及错误堆栈轨迹。

最佳实践

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

Reply to Reviews API

利用 Reply to Reviews API，您可以查看用户对您应用的反馈并回复相应反馈。您可以使用该 API 直接在您现有的客户服务工具包（例如 CRM 系统）中与用户互动。

借助 Reply to Reviews API，您只可访问正式版应用的相关反馈。如果您想查看有关应用的 Alpha 版或 Beta 版的反馈，请改用 Google Play 管理中心。另外请注意，此 API 仅显示包含评论的评价。如果用户仅对您的应用评分，但未提供评论，则无法通过此 API 访问其反馈。

Permissions API

Permissions API 让开发者能够在 Play 管理中心内自动执行权限管理。这样，您就可以灵活地控制哪些人员有权访问您的开发者账号，而无需进行手动干预。

您可以使用 Permissions API 执行管理功能，例如：

  • 移除已从公司离职的用户的访问权限。
  • 在用户加入相关团队时授予对应用的访问权限。

Voided Purchases API

Voided Purchases API 提供了一个与用户作废的购买交易相关的订单列表。您可以利用此列表中的信息来实现一个撤消系统，阻止用户访问这些订单中的商品。

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

在以下情况中，购买交易视为作废：

  • 用户针对其订单请求退款。
  • 用户取消其订单。
  • 订单被退款。
  • 开发者取消订单或针对订单办理退款。注意：Voided Purchases API 中只会显示已撤消的订单。如果开发者办理了退款，但未设置撤消选项，相应订单将不会显示在此 API 中。
  • Google 取消订单或针对订单办理退款。

通过使用此 API，您可以为应用（尤其是当您的应用为游戏时）的所有用户打造更平衡且公平的体验。