REST Resource: edits.tracks

Tài nguyên: Theo dõi

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

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

string

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

Các phiên bản theo hệ số hình dạng có một tiền tố đặc biệt làm giá trị nhận dạng, ví dụ: wear:production, automotive:production.

Thông tin chi tiết về tên kênh
releases[]

object (Release)

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

Bản phát hành

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
}
Các 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 bạn không đặt chính sách này, tên sẽ được tạo từ versionName của tệp APK. Nếu bản phát hành chứa nhiều APK, tên sẽ được tạo từ ngày đó.
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 trong các bản phát hành trước.
releaseNotes[]

object (LocalizedText)

Mô tả các 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ệ 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 tiến hành" hoặc "đã tạm dừng".
countryTargeting

object (CountryTargeting)

Chỉ phát hành ở một nhóm 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ả APK mới thêm vào bản phát hành sẽ được xem xét ở mức ưu tiên này. Có thể lấy các giá trị trong khoảng [0, 5], với 5 là mức độ ưu tiên cao nhất. Giá trị mặc định là 0. Không thể cập nhật inAppUpdatePriority sau khi ra mắt bản phát hành. Xem https://developer.android.com/guide/playcore/in-app-updates.

LocalizedText

Văn bản đã bản địa hoá bằng ngôn ngữ cụ thể.

Biểu diễn dưới dạng JSON 
{
  "language": string,
  "text": string
}
Các 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 chưa xác định.
draft APK của bản phát hành không được phân phối 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 nhóm nhỏ người dùng, được xác định bằng "userFraction".
halted APK của bản phát hành sẽ không còn được phân phối cho người dùng nữa. Những người dùng đã có những tệp APK này sẽ không bị ảnh hưởng.
completed Bản phát hành sẽ không có thêm thay đổi nào nữa. Tệp APK của bản phát hành này đang được phân phối cho tất cả người dùng, trừ phi họ đủ điều kiện nhận tệp APK của bản phát hành mới hơn.

CountryTargeting

Thông số nhắm mục tiêu theo quốc gia.

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

string

Các quốc gia cần nhắm mục tiêu, được xác định dưới dạng mã CLDR gồm 2 chữ cái.
includeRestOfWorld

boolean

Bao gồm "các quốc gia khác" cũng như các quốc gia được nhắm mục tiêu rõ ràng.

Phương thức

create

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

get

 Nhận được 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.