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: