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: