REST Resource: edits.tracks

Tài nguyên: Theo dõi

Cấu hình kênh. Tài nguyên cho TracksService.

Biểu diễn dưới dạng JSON
{
  "track": string,
  "releases": [
    {
      object (Release)
    }
  ]
}
Trường
track

string

Giá trị nhận dạng của bản nhạc.

Các kênh kiểu dáng có tiền tố đặc biệt làm giá trị nhận dạng, ví dụ: wear:production, automotive:production.

Thông tin khác về tên bản nhạc

releases[]

object (Release)

Trong yêu cầu đọc, đại diện cho tất cả bản phát hành đang hoạt động trong kênh. Trong yêu cầu cập nhật, đại diện cho các thay đổi mong muốn.

Bản phát hành

Một bản phát hành trong một kênh.

Biểu diễn dưới dạng JSON
{
  "name": string,
  "versionCodes": [
    string
  ],
  "releaseNotes": [
    {
      object (LocalizedText)
    }
  ],
  "status": enum (Status),
  "userFraction": number,
  "countryTargeting": {
    object (CountryTargeting)
  },
  "inAppUpdatePriority": integer
}
Trường
name

string

Tên bản phát hành. Không bắt buộc phải là duy nhất. Nếu không được đặt, tên sẽ được tạo từ versionName của APK. Nếu bản phát hành chứa nhiều tệp APK, tên sẽ được tạo từ ngày phát hành.

versionCodes[]

string (int64 format)

Mã phiên bản của tất cả tệp APK trong bản phát hành. Phải bao gồm mã phiên bản để giữ lại từ các bản phát hành trước.

releaseNotes[]

object (LocalizedText)

Nội dung mô tả về tính năng mới trong bản phát hành này.

status

enum (Status)

Trạng thái của bản phát hành.

userFraction

number

Tỷ lệ phần trăm người dùng đủ điều kiện sử dụng bản phát hành theo giai đoạn. 0 < phân số < 1. Chỉ có thể đặt khi trạng thái là "đang diễn ra" hoặc "đã tạm dừng".

countryTargeting

object (CountryTargeting)

Hạn chế bản phát hành ở một số quốc gia cụ thể.

inAppUpdatePriority

integer

Mức độ ưu tiên của bản cập nhật trong ứng dụng của bản phát hành. Tất cả tệp APK mới thêm vào trong bản phát hành sẽ được xem xét theo mức độ ưu tiên này. Có thể nhận giá trị trong phạm vi [0, 5], trong đó 5 là mức độ ưu tiên cao nhất. Mức mặc định là 0. Bạn không thể cập nhật inAppUpdatePriority sau khi bản phát hành được triển khai. Hãy xem https://developer.android.com/guide/playcore/in-app-updates.

LocalizedText

Văn bản đã bản địa hoá bằng ngôn ngữ nhất định.

Biểu diễn dưới dạng JSON
{
  "language": string,
  "text": string
}
Trường
language

string

Mã bản địa hoá ngôn ngữ (thẻ ngôn ngữ BCP-47; ví dụ: "de-AT" cho tiếng Đức ở Áo).

text

string

Văn bản bằng ngôn ngữ đã cho.

Trạng thái

Trạng thái của bản phát hành.

Enum
statusUnspecified Trạng thái không xác định.
draft Các tệp APK của bản phát hành không được phân phát cho người dùng.
inProgress Các tệp APK của bản phát hành đang được phân phát cho một phần người dùng, được xác định bằng "userFraction".
halted Các tệp APK của bản phát hành sẽ không được phân phát cho người dùng nữa. Những người dùng đã có các tệp APK này sẽ không bị ảnh hưởng.
completed Bản phát hành này sẽ không có thay đổi nào khác. Các tệp APK của bản phát hành này đang được phân phát cho tất cả người dùng, trừ phi họ đủ điều kiện sử dụng các tệp APK của bản phát hành mới hơn.

CountryTargeting

Thông số kỹ thuật về tiêu chí nhắm mục tiêu theo quốc gia.

Biểu diễn dưới dạng JSON
{
  "countries": [
    string
  ],
  "includeRestOfWorld": boolean
}
Trường
countries[]

string

Quốc gia cần nhắm đến, được chỉ định dưới dạng mã CLDR gồm hai chữ cái.

includeRestOfWorld

boolean

Bao gồm "các nơi khác trên thế giới" cũng như các quốc gia được nhắm đến một cách rõ ràng.

Phương thức

create

Tạo một bản nhạc mới.

get

Lấy một bản nhạc.

list

Liệt kê tất cả các bản nhạc.

patch

Vá một bản nhạc.

update

Cập nhật một bản nhạc.