编辑会话

您可以利用 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 管理中心进行更改时一样，这些更改可能数小时后才能生效。