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 được đưa vào, cụ thể là cách tài nguyên đó được dùng trong danh sách phát.

YouTube cũng 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ã nhận dạng 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 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ố yêu cầu API. Bạn có thể truy xuất tất cả các mục trong 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 chúng. Thử ngay.

chèn

Thêm một 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.

Cách trình bày 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: