REST Resource: edits.tracks

Tài nguyên: Theo dõi

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

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 phát hành cho từng 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 khác về tên bản nhạc

releases[]

object (Release)

Trong yêu cầu đọc, dữ liệu này đại diện cho tất cả bản phát hành đang hoạt động trên kênh. Trong yêu cầu cập nhật, hãy thể hiện những 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
}
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, thì tên này 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 từ các bản phát hành trước.

releaseNotes[]

object (LocalizedText)

Nội dung mô tả về 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 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à "inProgress" hoặc "tạm ngừng".

countryTargeting

object (CountryTargeting)

Giới hạn bản 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 được thêm vào trong 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. Hãy xem https://developer.android.com/guide/playcore/in-app-updates.

LocalizedText

Văn bản được bản địa hoá trong ngôn ngữ cho sẵn.

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 APK của bản phát hành không được phân phối cho người dùng.
inProgress Các APK của bản phát hành đang được phân phối 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 phân phối 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ó thêm thay đổi nào. Tệp APK của ứng dụng này đang được phân phối cho tất cả người dùng, trừ trường hợp những tệp APK này đủ điều kiện được dùng để tải tệp APK của một bản phát hành mới hơn.

CountryTargeting

Thông số kỹ thuật 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 mục tiêu, đượ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 mục tiêu rõ ràng.

Phương thức

create

Tạo bản phụ đề mới.

get

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

list

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

patch

Vá một kênh.

update

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