Google Play 开发者 API

概述

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

并非所有开发者都需要使用这些开发者 API——在大多数情况下，您可以继续使用 Google Play Console 直接管理您的应用。但是，如果您有大量 APK 需要管理，或者必须跟踪用户购买和订阅，您可能会发现这些 API 很有用。

包含内容

Google Play 开发者 API 让您专注于设计和开发您的应用，同时减少管理发布版本的时间和精力，即使您扩展到新市场也是如此。

Google Play Console 包含一套您可以用来管理应用的 API

  • 您可以使用 发布 API 上传和发布应用，以及执行其他与发布相关的任务。
  • 您可以使用 订阅和应用内购买 API 管理应用内购买和订阅。（以前称为“购买状态 API”。）
  • 您可以使用 报告 API 从 Android 核心指标中检索有关应用质量的信息。
  • 您可以使用 回复评论 API 检索并回复应用的评论。
  • 您可以使用 权限 API 自动执行 Play Console 中的权限管理。
  • 您可以使用 Play 游戏服务管理 API 发出 REST 调用以编程方式控制 Google Play 游戏服务功能的基础元数据。
  • 您可以使用 已作废购买 API 获取与用户已作废的购买关联的订单列表。

入门

要开始使用 Google Play 开发者 API，请参阅 入门 文档。

发布 API

您可以使用 发布 API 自动执行与应用分发相关的频繁任务。这提供了与开发者通过 Play Console 可用的功能类似的功能，例如

  • 上传应用的新版本
  • 通过将 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 Console 数据之上构建自动化工作流的开发者，或者将 Play Console 数据用于内部业务报告和分析（可能与其他数据集一起使用）的开发者，报告 API 是一个理想选择。这使您可以以编程方式访问应用级数据和指标，以用于内部报告、分析和自动化。

报告 API 提供对 Android 性能数据（包括崩溃率、ANR 率、唤醒和唤醒锁问题以及错误堆栈跟踪）的访问权限。

最佳实践

  • 此版本的报告 API 每秒默认限制 10 个查询。您可以在 Google Cloud Console 的配额部分查看您的配额使用情况。如果您需要超过此限制，可以使用此表单提交配额请求。

回复评论 API

使用回复评论 API，您可以查看应用的用户反馈并回复这些反馈。您可以使用此 API 在您现有的客户支持工具包（例如 CRM 系统）中直接与用户互动。

回复评论 API 允许您仅访问应用的生产版本的反馈。如果您想查看应用的 Alpha 版或 Beta 版的反馈，请使用 Google Play Console。另外，请注意，API 仅显示包含评论的评论。如果用户对您的应用进行评分但未提供评论，则无法通过 API 访问他们的反馈。

权限 API

权限 API 使开发者能够自动化 Play Console 中的权限管理。这可以让您灵活地控制谁可以访问您的开发者帐号，而无需人工干预。

使用权限 API，您可以执行以下管理功能：

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

无效购买 API

使用无效购买 API，您可以获取与用户已作废的购买相关的订单列表。您可以使用此列表中的信息来实现撤销系统，以防止用户访问这些订单中的产品。

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

购买可以以下列方式作废

  • 用户请求其订单的退款。
  • 用户取消其订单。
  • 订单被拒付。
  • 开发者取消或退款订单。注意：仅撤销的订单才会显示在无效购买 API 中。如果开发者退款时未设置撤销选项，则订单将不会显示在 API 中。
  • Google 取消或退款订单。

通过使用此 API，您可以帮助为所有应用用户（尤其是在您的应用是游戏的情况下）创造更平衡、更公平的体验。