Google Play Developer API-ESG跨境

Google Play Developer API

Google Play Developer API

注意：从2019年12月1日起，Google Play Developer API仅适用于版本3及更高版本。如果您使用的是较低版本的API，则必须在此日期之前迁移到版本3。如需详细了解如何迁移到版本3，请参阅Google Play Developer API的变化。

Google Play Developer API是一种基于REST的网络服务，利用这种服务，您可以执行应用发布和应用管理任务。您可以使用此API将您的发布操作与版本管理流程集成。

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

使用Google Play Developer API，您可以自动执行各种应用管理任务，包括：

·上传和发布应用的新版本

·修改应用的Google Play商店商品详情，包括已本地化的文字和图形

·管理您的应用内商品清单、商品购买状态和应用订阅

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

Google Play Developer API包括两个组件：

·利用Publishing API，您可以上传和发布应用，以及执行其他发布相关的任务。

·利用Subscriptions and InApp Purchases API，您可以管理应用内购买和订阅。（以前称为“Purchase Status API”。）

Publishing API

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

·上传应用的新版本

·通过将APK分配至各个轨道（Alpha版、Beta版、分阶段发布版本或正式版）来发布应用

·创建和修改Google Play商店中的商品详情，包括已本地化的文字和图形与多设备屏幕截图

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

注意：并不是所有开发者都需要使用此API。您也可以通过Google Play管理中心获得此API提供的所有功能。不过，利用此API，您可以将应用和商品详情更新流程与您现有的工具集成，这种功能对某些开发者来说非常实用。特别是，如果您有大量APK需要管理或者拥有多种不同语言区域的本地化商品详情，则可能会发现此API非常实用。

Subscriptions and InApp Purchases API

利用此API，您可以管理应用的应用内商品和订阅目录。此外，利用Subscriptions and InApp Purchases API，您还可以通过标准的GET请求快速检索任何购买交易的详情。在该请求中，您需要提供购买交易的相关信息：应用软件包名称、购买或订阅ID及购买令牌。服务器通过JSON对象响应，此对象将说明关联的购买交易详情、订单状态、开发者载荷和其他信息。

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

注意：Subscriptions and InApp Purchases API不使用Publishing API所用的新事务型“修改”功能。Inappproducts、Purchases.products和Purchases.subscriptions资源的方法会立即生效。每个资源的API参考文档页面都会特别指出该资源所用的方法是否使用“修改”模式。

Purchase Status API是Google Play Developer API v.2.0的一部分，可以通过Google Developers Console获得。

使用API

如需开始发起API调用，您需要直接从Google Play管理中心设置和管理Google Play Developer API。此API只能由您Google Play开发者帐号的所有者管理。

如需访问API，您需要执行以下操作：

1.设置一个新的API项目或一个现有的API项目

2.设置一个或多个获得授权的客户端，它们可以是下列两种选择之一：

·OAuth客户端

·服务帐号

如需了解完整详情，请参阅Google Play Developer API使用入门页面。

分阶段修改

利用Google Play Developer Publishing API的Edits方法，您可以准备并提交对Google Play应用的更改。在准备好更新后，只需一个操作即可将其部署。您可以进行的更改包括：

·上传一个或多个APK

·将不同的APK分配到不同的“轨道”：Alpha版、Beta版、分阶段发布版本和正式版

·为应用创建和修改已本地化的商品详情

·为应用的商品详情上传屏幕截图和其他图像

分阶段完成所有需要的更改后，只需一步操作即可将其全部提交。

如需了解分阶段修改的完整详情，请参阅Google Play Developer API Edits页面。

注意：新的事务型“修改”功能只能由Publishing API使用。Subscriptions and InApp Purchases API的方法将立即生效。每个资源的API参考文档页面都会特别指出该资源所用的方法是否使用“修改”模式。

有效使用API

管理对Google Play Developer API的访问有助于确保为使用它的所有应用创建一个高效的环境（如配额中所述）。尽管您可以为自己的应用请求较高的每日配额，我们仍强烈建议您通过以下方式尽可能减少访问次数：

发布

·限制应用更新的次数发布Alpha或Beta更新的频率每天不要超过一次。（正式版应用的更新频率应当更低。）每次更新都会消耗用户的时间，还可能花费他们的金钱。如果您更新的频率过于频繁，用户会开始忽略更新，甚至卸载产品。（当然，如果您的应用存在严重问题，则可以通过更新实施修复。）

一次性购买

·仅针对新的购买交易查询Purchase Status API发生购买时，您的应用会将购买令牌和其他详情传递到您的后端服务器，服务器可以使用Purchase Status API验证购买交易。

·将购买详情缓存到您的服务器上如果可能，请将应用内商品和订阅的购买详情缓存到您的后端服务器上。如果您的应用在运行时联系后端服务器来验证购买交易的有效性，您的服务器可以基于缓存的详情验证购买交易，以便最大程度减少Purchase Status API的使用并为用户提供尽可能快的响应（和最佳体验）。

订阅

·将订阅信息存储在您的服务器上，避免进行不必要的API调用。当您的应用需要验证订阅时，您应该依赖服务器上的缓存信息，而不是重复向Google发出API调用。

·在以下两种情况下，您的安全服务器应使用Google Play Developer API获取订阅信息：

·您的服务器收到了之前没有见过的新购买令牌。

·您的服务器收到一条实时开发者通知(RTDN)，该通知指明您需要使用购买令牌来获取新的订阅信息。

此外，还请注意以下事项：

·请勿通过定期轮询API来获取订阅状态。例如，不要每天调用API来检查每项订阅。

·由于您在订阅到期或续订时会收到RTDN，因此无需根据预定的过期时间安排API调用。

按照上面的这些指导原则操作，您的实现将为用户提供绝佳的性能。

配额

对于使用Google Play Developer API的应用来说，初始免费配额被限制为每天200000次请求（每款应用）。此配额应当可以满足发布Activity和正常的订阅验证需求。

如果您需要为自己的应用请求更高的配额，请使用Google Developers Console Quotas窗格中的“Request more”链接。

特别声明：以上文章内容仅代表作者本人观点，不代表ESG跨境电商观点或立场。如有关于作品内容、版权或其它问题请于作品发表后的30日内与ESG跨境电商联系。