PlaylistItems

Tài nguyên playlistItem xác định một tài nguyên khác, chẳng hạn như video, có trong danh sách phát. Ngoài ra, tài nguyên playlistItem chứa thông tin chi tiết về tài nguyên đi kèm liên quan cụ thể đến cách tài nguyên đó được sử dụng trong danh sách phát đó.

YouTube cũng sử dụng danh sách phát để xác định danh sách video đã tải lên của một kênh, trong đó mỗi playlistItem trong danh sách đó đại diện cho một video đã tải lên. Bạn có thể truy xuất mã danh sách phát cho danh sách đó từ tài nguyên channel cho một kênh nhất định. Sau đó, bạn có thể sử dụng phương thức playlistItems.list cho danh sách.

Phương thức

API này hỗ trợ các phương thức sau đây cho tài nguyên playlistItems:

list
Trả về một tập hợp các mục danh sách phát khớp với các tham số yêu cầu API. Bạn có thể truy xuất tất cả các mục trong danh sách phát trong một danh sách phát đã chỉ định hoặc truy xuất một hoặc nhiều mục trong danh sách phát theo mã nhận dạng duy nhất của các mục đó. Thử ngay.
chèn
Thêm tài nguyên vào danh sách phát. Thử ngay.
update
Sửa đổi một mục trong danh sách phát. Ví dụ: bạn có thể cập nhật vị trí của mục trong danh sách phát. Thử ngay.
xóa
Xoá một mục trong danh sách phát. Thử ngay.

Biểu thị tài nguyên

Cấu trúc JSON sau đây cho thấy định dạng của tài nguyên playlistItems:

{
  "kind": "youtube#playlistItem",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "videoOwnerChannelTitle": string,
    "videoOwnerChannelId": string,
    "playlistId": string,
    "position": unsigned integer,
    "resourceId": {
      "kind": string,
      "videoId": string,
    }
  },
  "contentDetails": {
    "videoId": string,
    "startAt": string,
    "endAt": string,
    "note": string,
    "videoPublishedAt": datetime
  },
  "status": {
    "privacyStatus": string
  }
}

Thuộc tính

Bảng sau đây xác định các thuộc tính xuất hiện trong tài nguyên này:

Thuộc tính
kind string
Xác định loại tài nguyên API. Giá trị sẽ là youtube#playlistItem.
etag etag
Etag của tài nguyên này.
id string
Mã mà YouTube sử dụng để nhận dạng duy nhất mục trong danh sách phát.
snippet object
Đối tượng snippet chứa thông tin chi tiết cơ bản về mục trong danh sách phát, chẳng hạn như tiêu đề và vị trí của mục đó trong danh sách phát.
snippet.publishedAt datetime
Ngày và giờ thêm mục vào danh sách phát. Giá trị được chỉ định ở định dạng ISO 8601.
snippet.channelId string
Mã mà YouTube sử dụng để xác định riêng người dùng đã thêm mục vào danh sách phát.
snippet.title string
Tiêu đề của mục.
snippet.description string
Nội dung mô tả của mặt hàng.
snippet.thumbnails object
Bản đồ hình thu nhỏ được liên kết với mục danh sách phát. Đối với mỗi đối tượng trong bản đồ, khoá là tên của hình thu nhỏ và giá trị là một đối tượng chứa thông tin khác về hình thu nhỏ.
snippet.thumbnails.(key) object
Các giá trị khoá hợp lệ là:
  • default – Hình thu nhỏ mặc định. Hình thu nhỏ mặc định cho một video (hoặc tài nguyên tham chiếu đến một video, chẳng hạn như một mục trong danh sách phát hoặc kết quả tìm kiếm) có chiều rộng 120 pixel và chiều cao 90 pixel. Hình thu nhỏ mặc định của một kênh có chiều rộng 88 pixel và chiều cao 88 pixel.
  • medium – Phiên bản hình thu nhỏ có độ phân giải cao hơn. Đối với video (hoặc tài nguyên tham chiếu đến video), hình ảnh này có chiều rộng 320 px và chiều cao 180 px. Đối với kênh, hình ảnh này có chiều rộng 240 pixel và chiều cao 240 pixel.
  • high – Phiên bản hình thu nhỏ có độ phân giải cao. Đối với video (hoặc tài nguyên tham chiếu đến video), hình ảnh này có chiều rộng 480 pixel và chiều cao 360 pixel. Đối với kênh, hình ảnh này có chiều rộng 800 pixel và chiều cao 800 pixel.
  • standard – Phiên bản hình thu nhỏ có độ phân giải cao hơn cả hình ảnh có độ phân giải high. Hình ảnh này xuất hiện trên một số video và các tài nguyên khác liên quan đến video, chẳng hạn như mục trong danh sách phát hoặc kết quả tìm kiếm. Hình ảnh này có chiều rộng 640 px và chiều cao 480 px.
  • maxres – Phiên bản hình thu nhỏ có độ phân giải cao nhất. Kích thước hình ảnh này được áp dụng cho một số video và các tài nguyên khác liên quan đến video, chẳng hạn như mục trong danh sách phát hoặc kết quả tìm kiếm. Hình ảnh này có chiều rộng 1280 pixel và chiều cao 720 pixel.
snippet.thumbnails.(key).url string
URL của hình ảnh.
snippet.thumbnails.(key).width unsigned integer
Chiều rộng của hình ảnh.
snippet.thumbnails.(key).height unsigned integer
Chiều cao của hình ảnh.
snippet.channelTitle string
Tiêu đề kênh của kênh chứa mục danh sách phát.
snippet.videoOwnerChannelTitle string
Tên kênh của kênh đăng tải video này.
snippet.videoOwnerChannelId string
Mã nhận dạng của kênh đã tải video này lên.
snippet.playlistId string
Mã mà YouTube sử dụng để nhận dạng duy nhất danh sách phát chứa mục danh sách phát.
snippet.position unsigned integer
Thứ tự xuất hiện của mục trong danh sách phát. Giá trị này sử dụng chỉ mục bắt đầu từ 0, vì vậy, mục đầu tiên có vị trí là 0, mục thứ hai có vị trí là 1, v.v.
snippet.resourceId object
Đối tượng id chứa thông tin có thể dùng để xác định duy nhất tài nguyên có trong danh sách phát dưới dạng mục danh sách phát.
snippet.resourceId.kind string
Loại hoặc kiểu của tài nguyên được tham chiếu.
snippet.resourceId.videoId string
Nếu giá trị của thuộc tính snippet.resourceId.kind là youtube#video, thì thuộc tính này sẽ xuất hiện và giá trị của thuộc tính này sẽ chứa mã nhận dạng mà YouTube sử dụng để nhận dạng duy nhất video trong danh sách phát.
contentDetails object
Đối tượng contentDetails được đưa vào tài nguyên nếu mục được đưa vào là video trên YouTube. Đối tượng này chứa thêm thông tin về video.
contentDetails.videoId string
Mã mà YouTube sử dụng để nhận dạng duy nhất một video. Để truy xuất tài nguyên video, hãy đặt tham số truy vấn id thành giá trị này trong yêu cầu API.
contentDetails.startAt string
Lưu ý: Thuộc tính này không còn được dùng nữa và nếu được đặt, giá trị của thuộc tính này sẽ bị bỏ qua.

Thời gian (được tính bằng giây kể từ đầu video) khi video bắt đầu phát. (Chủ sở hữu danh sách phát có thể chỉ định thời điểm video bắt đầu và dừng phát khi video được phát trong danh sách phát.) Giá trị mặc định là 0.
contentDetails.endAt string
Lưu ý: Thuộc tính này không còn được dùng nữa và nếu được đặt, giá trị của thuộc tính này sẽ bị bỏ qua.

Thời gian (tính bằng giây kể từ khi bắt đầu video) mà video sẽ ngừng phát. (Chủ sở hữu danh sách phát có thể chỉ định thời điểm video bắt đầu và dừng phát khi video được phát trong danh sách phát.) Theo mặc định, giả sử video.endTime là cuối video.
contentDetails.note string
Ghi chú do người dùng tạo cho mục này. Giá trị thuộc tính có độ dài tối đa là 280 ký tự.
contentDetails.videoPublishedAt datetime
Ngày và giờ xuất bản video lên YouTube. Giá trị được chỉ định ở định dạng ISO 8601.
status object
Đối tượng status chứa thông tin về trạng thái quyền riêng tư của mục danh sách phát.
status.privacyStatus string
Trạng thái quyền riêng tư của mục trong danh sách phát. Kênh đã tải video mà mục danh sách phát đại diện lên có thể đặt giá trị này bằng phương thức videos.insert hoặc videos.update.