PlaylistItems

playlistItem 리소스는 재생목록에 포함된 동영상과 같은 다른 리소스를 식별합니다. 또한 playlistItem 리소스에는 포함된 리소스에 관한 세부정보가 포함되어 있으며, 이 세부정보는 해당 리소스가 재생목록에서 사용되는 방식과 관련이 있습니다.

YouTube는 재생목록을 사용하여 채널의 업로드된 동영상 목록을 식별하며, 목록의 각 playlistItem는 업로드된 동영상 1개를 나타냅니다. 특정 채널의 channel 리소스에서 해당 목록의 재생목록 ID를 가져올 수 있습니다. 그런 다음 목록에 playlistItems.list 메서드를 사용할 수 있습니다.

메서드

API는 playlistItems 리소스에 대해 다음 메서드를 지원합니다.

list

API 요청 매개변수와 일치하는 재생목록 항목 컬렉션을 반환합니다. 지정된 재생목록의 모든 항목을 검색하거나 고유 ID를 통해 하나 또는 여러 개의 재생목록 항목을 검색할 수 있습니다. 지금 사용해보기

insert

재생목록에 리소스를 추가합니다. 지금 사용해보기

업데이트

재생목록 항목을 수정합니다. 예를 들어 재생목록에서 항목의 위치를 업데이트할 수 있습니다. 지금 사용해보기

삭제

재생목록 항목을 삭제합니다. 지금 사용해보기

리소스 표현

다음 JSON 구조에서 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
  }
}

속성

다음 표는 이 리소스에 표시되는 속성을 정의합니다.