编辑会话

利用 Google Play Developer Publishing API 的 Edits 方法，您可以准备对 Google Play 应用的多项更改，然后一次性部署这些更改。为此，您可以创建修改，其中包含您要对应用进行的所有更改。修改包含如下信息：

• 与应用相关联的 APK，以及每个 APK 所对应的“轨道”。

  每个 APK 都与一个“轨道”相关联，用于确定哪些用户可以看到相应 APK。这样，您就可以为测试人员提供应用的 Alpha 版和 Beta 版。此外，您还可以提供小范围发布的“分阶段发布”应用版本；此应用会自动投放给有限数量的应用用户（由您设置的发布比例决定），让您能够逐步部署新的正式版应用。

• 特定于语言和语言区域的应用 Google Play 商品详情版本

  每个特定于语言区域的商品详情版本都可以包含屏幕截图和其他宣传图片、已本地化的说明性文字等内容。

注意：并非 Google Play Developer API 提供的所有方法都使用新的事务性“修改”功能。无论应用是否有处于开放状态的修改，用于 inappproducts、products 和 subscriptions 资源的方法都会立即生效。每个资源的 API 参考文档页面都会特别指出相应资源所用的方法是否使用“修改”模式。

当您首次创建修改时，该修改是当前部署的应用状态的副本。之后，您可以通过调用“Edits”方法来修改此修改。修改准备就绪后，您可以将其提交，从而发布相应更改。您还可以随时放弃修改，以便舍弃相应更改并让应用保持原样。

您只能使用该 API 更改现有应用（即已上传至少一个 APK 的应用）；因此，您必须先通过 Play 管理中心上传至少一个 APK，然后才能使用该 API。此外，您也无法使用该 API 将应用状态从“已发布”更改为“未发布”，或将其用于填写发布应用所需的法律同意书。如需发布应用，您必须使用 Play 管理中心。

注意：如果您的修改正在进行中，而此时有人通过 Google Play 管理中心对相应应用进行更改，则您的修改将被舍弃，而通过 Play 管理中心进行的更改将会生效。

工作流程

本部分将介绍您可以通过哪些典型方式利用 Google Play Developer Publishing API 的 Edits 方法来修改应用。

1. 调用 Edits: Insert 并指定要修改的应用，从而创建新修改。

   此操作会创建指定应用的新修改。系统会从相应应用的已部署版本中复制应用的初始设置（APK、商品详情、扩展文件等）。

2. 根据需要修改相应修改。

   可通过 Google Play 管理中心进行的大多数更改都可以通过这种方式完成。为此，您可以调用相应的 Google Play Developer API 方法，然后传递您要修改的应用的 ID和要修改的修改的 ID。具体而言：

   • 您可以通过调用 Edits.apks: upload 来上传新 APK。此操作会将 APK 置于某个存储区域中，以便将其分配给本修改或后续修改中的某个轨道。
   • 您可以通过调用 Edits.tracks: update 将 APK 分配到轨道。您还可以通过调用 Edits.tracks: patch 来更改现有 APK 的轨道分配。
   • 您可以通过调用 Edits.listings: update 来创建新的本地化商品详情。您可以通过调用 Edits.listings: patch 来修改现有商品详情。
   • 您可以通过调用 Edits.expansionfiles resource 方法来添加或修改扩展文件。

   这些方法可对正在进行的修改进行更改，但不会修改已发布的应用版本。您可以进一步进行更改或舍弃正在进行的修改，而不会影响用户体验。

   注意：每位用户一次只能打开一个修改。如果您创建新修改，则已经打开的任何现有修改就会变为无效。此外，如果有人提交应用的修改或通过 Play 管理中心更改应用，则该应用的所有其他修改（不论由哪个用户所有）都会变为无效。如果您尝试提交无效的修改，操作便会抛出异常，并且不会产生任何效果。

3. 提交修改。

   当您调用 Edits: commit 时，如果没有验证错误，那么 edits 资源中指定的所有更改都会“发布”，从而替换应用的当前状态。与通过 Play 管理中心进行更改时一样，这些更改可能数小时后才能生效。