REST Resource: edits.tracks

资源:曲目

轨道配置。TracksService 的资源。

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

string

曲目的标识符。

外形规格轨道使用特殊前缀作为标识符,例如 wear:productionautomotive: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。只有在状态为“进行中”或“已暂停”时才能设置。

countryTargeting

object (CountryTargeting)

将发布版本限制为一组特定的国家/地区。

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

更新轨道。