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
  }
}

속성

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

속성
kind string
API 리소스의 유형을 식별합니다. 값은 youtube#playlistItem입니다.
etag etag
이 리소스의 Etag입니다.
id string
YouTube에서 재생목록 항목을 고유하게 식별하는 데 사용하는 ID입니다.
snippet object
snippet 객체에는 재생목록 항목의 제목, 재생목록 내 위치와 같은 재생목록 항목에 관한 기본 세부정보가 포함되어 있습니다.
snippet.publishedAt datetime
재생목록에 항목이 추가된 날짜 및 시간입니다. 값은 ISO 8601 형식으로 지정됩니다.
snippet.channelId string
YouTube에서 재생목록에 항목을 추가한 사용자를 고유하게 식별하는 데 사용하는 ID입니다.
snippet.title string
항목의 제목입니다.
snippet.description string
상품 설명입니다.
snippet.thumbnails object
재생목록 항목과 연결된 썸네일 이미지의 지도입니다. 맵의 각 개체에 대해, 키는 미리보기 이미지의 이름이고 값은 미리보기 이미지에 대한 기타 정보를 포함하는 개체입니다.
snippet.thumbnails.(key) object
유효한 키 값은 다음과 같습니다.
  • default – 기본 썸네일 이미지입니다. 동영상 또는 동영상을 참조하는 리소스(예: 재생목록 항목, 검색 결과)의 기본 썸네일은 너비 120픽셀, 높이 90픽셀입니다. 채널의 기본 미리보기 이미지는 88x88픽셀입니다.
  • medium – 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이 이미지의 너비는 320px, 높이는 180px입니다. 채널의 경우 이 이미지는 240x240픽셀입니다.
  • high – 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이 이미지는 너비 480px, 높이 360px입니다. 채널의 경우 이 이미지는 800x800픽셀입니다.
  • standard: high 해상도 이미지보다 썸네일 이미지의 해상도가 더 높습니다. 이 이미지는 일부 동영상과 동영상을 참조하는 다른 리소스(예: 재생목록 항목, 검색 결과)에 사용할 수 있습니다. 이 이미지의 너비는 640px, 높이는 480px입니다.
  • maxres – 썸네일 이미지의 최고 해상도 버전입니다. 이 이미지 크기는 일부 동영상과 동영상을 참조하는 다른 리소스(예: 재생목록 항목, 검색 결과)에 사용할 수 있습니다. 이 이미지의 너비는 1280px, 높이는 720px입니다.
snippet.thumbnails.(key).url string
이미지의 URL입니다.
snippet.thumbnails.(key).width unsigned integer
이미지의 너비입니다.
snippet.thumbnails.(key).height unsigned integer
이미지의 높이입니다.
snippet.channelTitle string
재생목록 항목이 속한 채널의 채널 제목입니다.
snippet.videoOwnerChannelTitle string
이 동영상을 업로드한 채널의 채널 제목입니다.
snippet.videoOwnerChannelId string
이 동영상을 업로드한 채널의 채널 ID입니다.
snippet.playlistId string
YouTube에서 재생목록 항목이 포함된 재생목록을 고유하게 식별하는 데 사용하는 ID입니다.
snippet.position unsigned integer
재생목록에 항목이 표시되는 순서입니다. 이 값은 0 기준 색인을 사용하므로 첫 번째 항목의 위치는 0이고 두 번째 항목의 위치는 1입니다.
snippet.resourceId object
id 객체에는 재생목록에 재생목록 항목으로 포함된 리소스를 고유하게 식별하는 데 사용할 수 있는 정보가 포함되어 있습니다.
snippet.resourceId.kind string
참조된 리소스의 종류 또는 유형입니다.
snippet.resourceId.videoId string
snippet.resourceId.kind 속성의 값이 youtube#video인 경우 이 속성이 표시되며 값에는 YouTube가 재생목록에서 동영상을 고유하게 식별하는 데 사용하는 ID가 포함됩니다.
contentDetails object
포함된 항목이 YouTube 동영상인 경우 contentDetails 객체가 리소스에 포함됩니다. 개체는 동영상에 대한 추가 정보를 포함합니다.
contentDetails.videoId string
YouTube에서 동영상을 고유하게 식별하는 데 사용하는 ID입니다. video 리소스를 검색하려면 API 요청에서 id 쿼리 매개변수를 이 값으로 설정합니다.
contentDetails.startAt string
참고: 이 속성은 지원 중단되었으며 설정된 경우 값이 무시됩니다.

동영상 재생이 시작되는 시간을 동영상 시작 부분부터 초 단위로 측정한 값입니다. 재생목록 소유자는 재생목록 컨텍스트에서 동영상이 재생될 때 동영상 재생을 시작하고 중지해야 하는 시간을 지정할 수 있습니다. 기본값은 0입니다.
contentDetails.endAt string
참고: 이 속성은 지원 중단되었으며 설정된 경우 값이 무시됩니다.

동영상 재생을 중지해야 할 시간을 동영상 시작 부분부터 초 단위로 측정합니다. 재생목록 소유자는 재생목록 맥락에서 동영상이 재생될 때 동영상 재생을 시작하고 중지해야 하는 시간을 지정할 수 있습니다. 기본적으로 video.endTime가 동영상의 끝이라고 가정합니다.
contentDetails.note string
사용자가 생성한 이 항목에 관한 메모입니다. 속성 값의 최대 길이는 280자(영문 기준)입니다.
contentDetails.videoPublishedAt datetime
동영상이 YouTube에 게시된 날짜 및 시간입니다. 값은 ISO 8601 형식으로 지정됩니다.
status object
status 객체에는 재생목록 항목의 개인 정보 보호 상태에 관한 정보가 포함됩니다.
status.privacyStatus string
재생목록 항목의 공개 상태입니다. 재생목록 항목이 나타내는 동영상을 업로드한 채널은 videos.insert 또는 videos.update 메서드를 사용하여 이 값을 설정할 수 있습니다.