REST Resource: edits.tracks

資源：Track

階段設定。TracksService 的資源。

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

string

曲目的 ID。

外型規格軌會使用特殊前置字串做為 ID，例如 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)

將發行範圍限制在特定國家/地區。請注意，只有正式版測試群組中「進行中」的版本可以設定這項功能。
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 系統會根據「userFraction」向部分使用者提供該版本的 APK。
halted 使用者將無法再取得該版本的 APK。已安裝這些 APK 的使用者不受影響。
completed 這個版本不會再有任何變更。除非使用者符合較新版本的 APK 資格，否則系統會向所有使用者提供這個版本的 APK。

CountryTargeting

指定國家/地區規格。

JSON 表示法 
{
  "countries": [
    string
  ],
  "includeRestOfWorld": boolean
}
欄位
countries[]

string

指定為兩個字母的 CLDR 代碼。
includeRestOfWorld

boolean

請納入「其他國家/地區」和明確指定的國家/地區。

方法

create

 建立新音軌。

get

 取得軌跡。

list

 列出所有曲目。

patch

 修補音軌。

update

 更新曲目。

錯誤代碼

這項資源的作業會傳回下列 HTTP 錯誤碼：

錯誤代碼 原因 解析度
5xx Google Play 伺服器發生一般錯誤。 重試要求。

如果問題持續發生，請與 Google Play 帳戶管理員聯絡，或提交支援要求。 建議查看 Play 狀態資訊主頁，瞭解是否有已知服務中斷情形。
409 並行更新錯誤。

嘗試更新正在更新的物件。舉例來說，購買交易同時透過呼叫 Play 帳款服務程式庫的 acknowledgePurchase() 方法和 Play Developer API 的 purchases.products.acknowledge 進行確認。

 重試要求。