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 cụ thể về cách sử dụng tài nguyên đó trong danh sách phát đó.

YouTube cũng sử dụng danh sách phát để xác định danh sách các 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ã nhận dạng danh sách phát cho danh sách đó từ channel resource 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 này.

Phương pháp

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

list
Trả về một tập hợp các mục trong danh sách phát phù hợp với các tham số của 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 được chỉ định hoặc truy xuất một hoặc nhiều mục danh sách phát theo ID duy nhất. Thử ngay.
chèn
Thêm tài nguyên vào danh sách phát. Thử ngay.
cập nhật
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 diễn 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ã nhận dạng 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 cơ bản về mục trong danh sách phát, chẳng hạn như tiêu đề và vị trí của danh sách phát.
snippet.publishedAt datetime
Ngày và giờ mà mục được thêm vào danh sách phát. Giá trị này được chỉ định ở định dạng ISO 8601.
snippet.channelId string
Mã nhận dạng mà YouTube sử dụng để nhận dạng 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ặt hàng.
snippet.description string
Nội dung mô tả của mặt hàng.
snippet.thumbnails object
Bản đồ hình thu nhỏ liên kết với mục trong 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à đố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 của video hoặc tài nguyên đề cập đế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 là 120px và chiều cao là 90px. Hình thu nhỏ mặc định của một kênh có chiều rộng 88px và chiều cao 88px.
  • 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 đề cập đến video), hình ảnh này có chiều rộng 320px và chiều cao 180px. Đối với một kênh, hình ảnh này rộng 240px và cao 240px.
  • 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 đề cập đến video), hình ảnh này có chiều rộng 480px và chiều cao 360px. Đối với một kênh, hình ảnh này có chiều rộng 800px và chiều cao 800px.
  • standard – Phiên bản hình thu nhỏ thậm chí còn cao hơn phiên bản hình ảnh có độ phân giải high. Hình ảnh này có sẵn cho một số video và các tài nguyên khác đề cập đến video, chẳng hạn như các mục trong danh sách phát hoặc kết quả tìm kiếm. Hình ảnh này rộng 640 px và 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ó sẵn cho một số video và các tài nguyên khác đề cập đến video, như các 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 1280px và chiều cao 720px.
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
Tên kênh của kênh có mục trong danh sách phát.
snippet.videoOwnerChannelTitle string
Tiêu đề của kênh đã tải video này lên.
snippet.videoOwnerChannelId string
Mã nhận dạng của kênh đã tải video này lên.
snippet.playlistId string
Mã nhận dạng mà YouTube sử dụng để nhận dạng riêng danh sách phát có chứa mục đó.
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 dựa trên 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 để nhận dạng duy nhất tài nguyên có trong danh sách phát dưới dạng mục trong danh sách phát.
snippet.resourceId.kind string
Loại hoặc loại tài nguyên được giới thiệu.
snippet.resourceId.videoId string
Nếu giá trị của thuộc tính snippet.resourceId.kindyoutube#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ông tin bổ sung về video.
contentDetails.videoId string
Mã nhận dạng 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 bị đặt thì giá trị của thuộc tính này sẽ bị bỏ qua.

Thời gian đo được tính bằng giây kể từ lúc 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 đã ngừng hoạt động và nếu được đặt thì giá trị của thuộc tính này sẽ bị bỏ qua.

Thời gian đo được tính bằng giây kể từ lúc 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.) 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ị này đượ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 trong 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 mà 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.