REST Resource: edits.tracks

Tài nguyên: Bản nhạc

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 bản phát hành theo kiểu dáng có một tiền tố đặc biệt làm mã nhận dạng, ví dụ: wear:production, automotive:production.

Thông tin khác về tên bài hát
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 bản phát hà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 bạn không đặ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, thì tên sẽ được tạo theo ngày.
versionCodes[]

string (int64 format)

Mã phiên bản của tất cả APK trong bản phát hành. Phải có 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ề những điểm 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 nhận 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 "halted".
countryTargeting

object (CountryTargeting)

Giới hạn bản phát hành ở một nhóm quốc gia cụ thể. Xin lưu ý rằng bạn chỉ được phép đặt chế độ này cho các bản phát hành đang diễn ra ở kênh phát hành công khai.
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ả các APK mới được thêm vào bản phát hành sẽ được xem xét ở mức độ ưu tiên này. Có thể nhận các giá trị trong phạm vi [0, 5], trong đó 5 là mức độ ưu tiên cao nhất. Giá trị mặc định là 0. Bạn không thể cập nhật inAppUpdatePriority sau khi phát hành 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á 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 chưa xác định.
draft Các APK của bản phát hành không được phân phát cho người dùng.
inProgress Các 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 APK của bản phát hành sẽ không còn được phân phát cho người dùng nữa. Những người dùng đã cài đặt các 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 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 nhận các APK của một bản phát hành gần đây hơn.

CountryTargeting

Quy cá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

Các quốc gia cần nhắm đến, được chỉ định dưới dạng mã CLDR gồm 2 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 phụ đề 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.

Mã lỗi

Các thao tác của tài nguyên này sẽ trả về các mã lỗi HTTP sau:

Mã lỗi Lý do Mô tả Độ phân giải
400 invalidValue Bạn đã cung cấp một giá trị không hợp lệ trong yêu cầu. Lỗi này thường xảy ra khi mã thông báo mua hàng bị lỗi hoặc không hợp lệ. Hãy sửa giá trị trường không hợp lệ trong nội dung hoặc tham số yêu cầu dựa trên tài liệu tham khảo API.
400 required Yêu cầu thiếu một trường hoặc tham số bắt buộc. Tham khảo tài liệu API để đảm bảo bạn đã thêm tất cả các trường và tham số bắt buộc.
403 userInsufficientPermission Người dùng không có đủ quyền để thực hiện thao tác được yêu cầu. Đảm bảo người dùng được xác thực có các quyền cần thiết trong Google Play Console. Hãy xem phần Sử dụng tài khoản dịch vụ để biết thêm thông tin.
404 notFound Không tìm thấy tài nguyên được yêu cầu. Xác minh rằng các giá trị nhận dạng (ví dụ: mã thông báo giao dịch mua, tên gói, mã sản phẩm, mã thuê bao) là chính xác.
409 concurrentUpdate Đã có một nỗ lực cập nhật một đối tượng đang được cập nhật đồng thời. Thử lại yêu cầu với thời gian đợi luỹ thừa. Tránh sửa đổi đồng thời cùng một tài nguyên.
5xx Generic error Lỗi chung trong máy chủ Google Play. Hãy thử gửi lại yêu cầu.

Nếu vấn đề vẫn tiếp diễn, hãy liên hệ với người quản lý tài khoản Google Play hoặc gửi yêu cầu hỗ trợ. Hãy cân nhắc kiểm tra Trang tổng quan về trạng thái của Play để xem có sự cố ngừng hoạt động nào đã biết hay không.