PlaylistItems

Tài nguyên playlistItem xác định một tài nguyên khác, chẳng hạn như một video, có trong danh sách phát. Ngoài ra, tài nguyên playlistItem còn chứa thông tin chi tiết về tài nguyên đi kèm liên quan cụ thể đến 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 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 của một kênh cụ thể. Sau đó, bạn có thể sử dụng phương thức playlistItems.list cho danh sách.

Phương thức

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 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 thuộc một danh sách phát cụ thể 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.
cập nhật
Điều chỉnh 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
Xóa một mục trong danh sách phát. Thử ngay.

Trình bày tài nguyên

Cấu trúc JSON dưới đây thể hiện đị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
Thẻ Etag của tài nguyên này.
id string
Mã nhận dạng mà YouTube dùng để xác định riêng biệt một mục trong danh sách phát.
snippet object
Đối tượng snippet chứa các thông tin cơ bản về mục 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 theo định dạng ISO 8601.
snippet.channelId string
Mã nhận dạng mà YouTube sử dụng để xác định chính xác người dùng đã thêm nội dung đó 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 đồ các hình ả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à 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 của video (hoặc tài nguyên đề cập đến video), chẳng hạn như mục trong danh sách phát hoặc kết quả tìm kiếm, có chiều rộng 120px và chiều cao 90px. Hình thu nhỏ mặc định cho kênh có chiều rộng 88 px và chiều cao 88 px.
  • 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 rộng 320px và cao 180px. Đối với 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 một video), hình ảnh này rộng 480px và cao 360px. Đối với kênh, hình ảnh này rộng 800px và cao 800px.
  • standard – Phiên bản hình thu nhỏ có độ phân giải cao hơn so với hình ảnh có độ phân giải high. Hình ảnh này khả dụng cho một số video và 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 rộng 640 px và cao 480 px.
  • maxres – Phiên bản có độ phân giải cao nhất của hình thu nhỏ. Kích thước hình ảnh này áp dụng cho một số video và 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 1280 px và cao 720 px.
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
Tiêu đề kênh của kênh đã tải video này lên.
snippet.videoOwnerChannelId string
Mã nhận dạng kênh của kênh đã tải video này lên.
snippet.playlistId string
Mã nhận dạng mà YouTube dùng để xác định 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, do đó 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 đưa vào danh sách phát dưới dạng một mục danh sách phát.
snippet.resourceId.kind string
Loại hoặc loại của tài nguyên được đề cập.
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 dùng để xác định riêng biệt video trong danh sách phát.
contentDetails object
Đối tượng contentDetails sẽ được đưa vào tài nguyên nếu mục được đưa vào là một 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 dùng để xác định riêng biệ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 của bạn.
contentDetails.startAt string
Lưu ý: Thuộc tính này không còn được dùng nữa và nếu bạn đặt thuộc tính này, thì giá trị của thuộc tính này sẽ bị bỏ qua.

Thời gian (tính bằng giây) tính từ đầu video, khi video sẽ bắt đầu phát. (Chủ sở hữu danh sách phát có thể chỉ định thời điểm video sẽ bắt đầu và dừng phát khi video được phát theo ngữ cảnh của 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 bạn đặt thuộc tính này, thì giá trị của thuộc tính này sẽ bị bỏ qua.

Thời gian (tính bằng giây) tính từ lúc bắt đầu video, thời điểm video sẽ dừng phát. (Chủ sở hữu danh sách phát có thể chỉ định thời điểm video sẽ bắt đầu và dừng phát khi video được phát theo ngữ cảnh của danh sách phát). Theo mặc định, giả định rằng video.endTime là phần cuối của 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 theo đị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 lên mà mục trong danh sách phát đại diện có thể đặt giá trị này bằng cách sử dụng phương thức videos.insert hoặc videos.update.