REST Resource: edits.tracks

资源：Track

轨道配置。TracksService 的资源。

JSON 表示法 
{
  "track": string,
  "releases": [
    {
      object (Release)
    }
  ]
}
字段
track

string

轨道的标识符。

不同设备规格对应的发布轨道具有各自的特殊前缀作为标识符，例如 wear:production、automotive:production。

有关轨道名称的更多信息
releases[]

object (Release)

在读取请求中，表示轨道中的所有有效发布版本。在更新请求中，表示所需的更改。

版本

轨道内的发布版本。

JSON 表示法 
{
  "name": string,
  "versionCodes": [
    string
  ],
  "releaseNotes": [
    {
      object (LocalizedText)
    }
  ],
  "status": enum (Status),
  "userFraction": number,
  "countryTargeting": {
    object (CountryTargeting)
  },
  "inAppUpdatePriority": integer
}
字段
name

string

发布版本名称。无需具有唯一性。如果未设置，则系统会根据 APK 的 versionName 生成发布版本名称。如果发布版本包含多个 APK，则系统会根据日期生成发布版本名称。
versionCodes[]

string (int64 format)

发布版本中所有 APK 的版本代码。必须包含从之前发布版本中保留的版本代码。
releaseNotes[]

object (LocalizedText)

有关相应发布版本中新变化的说明。
status

enum (Status)

发布版本的状态。
userFraction

number

有资格使用分阶段发布版本的用户所占比例。相应值必须介于 0 到 1 之间。仅当状态为“inProgress”或“halted”时才可以设置。
countryTargeting

object (CountryTargeting)

将发布版本限制在一组特定的国家/地区。请注意，此设置仅允许针对正式版轨道中的 inProgress 版本进行设置。
inAppUpdatePriority

integer

发布版本的应用内更新优先级。发布版本中所有新添加的 APK 都将被视为具有此优先级。相应值介于 0 到 5 之间，其中 5 代表最高优先级。默认为 0。发布版本发布后，inAppUpdatePriority 将无法更新。请参阅 https://developer.android.com/guide/playcore/in-app-updates。

LocalizedText

已本地化的文本（采用指定语言）。

JSON 表示法 
{
  "language": string,
  "text": string
}
字段
language

string

本地化语言代码（BCP-47 语言标记；例如：“de-AT”表示奥地利德语）。
text

string

采用指定语言的文本。

状态

发布版本的状态。

枚举
statusUnspecified 未指定状态。
draft 发布版本的 APK 未向用户提供。
inProgress 发布版本的 APK 正在向一部分用户提供，具体由“userFraction”确定。
halted 发布版本的 APK 将不再向用户提供。已经拥有这些 APK 的用户不受影响。
completed 发布版本将不会再有进一步的变更。其 APK 正在向所有用户提供，除非这些用户有资格使用较新版本的 APK。

CountryTargeting

国家/地区定位规范。

JSON 表示法 
{
  "countries": [
    string
  ],
  "includeRestOfWorld": boolean
}
字段
countries[]

string

要定位到的国家/地区，以两个字母的 CLDR 代码来指定。
includeRestOfWorld

boolean

包括“其他国家/地区”以及明确定位到的国家/地区。

方法

create

 创建新轨道。

get

 获取轨道。

list

 列出所有轨道。

patch

 修补轨道。

update

 更新轨道。

错误代码

此资源的操作会返回以下 HTTP 错误代码：

错误代码 原因 说明 分辨率
400 invalidValue 请求中提供的值无效。如果购买令牌格式有误或无效，系统通常会返回此错误。 根据 API 参考文档，更正请求正文或参数中的无效字段值。
400 required 请求中缺少必需的字段或参数。 请参阅 API 文档，确保包含所有必填字段和参数。
403 userInsufficientPermission 用户没有足够的权限来执行所请求的操作。 确保经过身份验证的用户在 Google Play 管理中心内拥有必要的权限。如需了解详情，请参阅 使用服务账号。
404 notFound 找不到所请求的资源。 验证标识符（例如购买令牌、软件包名称、商品 ID、订阅 ID）是否正确。
409 concurrentUpdate 尝试更新正在并发更新的对象。 使用指数退避算法重试请求。避免同时修改同一资源。
5xx Generic error Google Play 服务器中的一般错误。 请重试您的请求。

如果问题仍然存在，请与您的 Google Play 客户经理联系，或提交支持请求。不妨查看 Play 状态信息中心，了解是否存在任何已知的服务中断。