playlistItem
리소스는 재생목록에 포함된 다른 리소스(예: 동영상)를 식별합니다. 또한 playlistItem
리소스에는 재생목록에서 리소스가 사용되는 방식과 관련하여 포함된 리소스에 관한 세부정보가 포함되어 있습니다.
YouTube는 또한 재생목록을 사용하여 채널에 업로드된 동영상의 목록을 식별하며 해당 목록의 각 playlistItem
는 업로드된 동영상 1개를 나타냅니다. 특정 채널의 channel resource
에서 목록의 재생목록 ID를 검색할 수 있습니다. 그런 다음 playlistItems.list
메서드를 사용하여 목록에 추가하면 됩니다.
방법
API는 playlistItems
리소스에 다음 메서드를 지원합니다.
리소스 표현
다음 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 유효한 키 값은 다음과 같습니다.
|
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 리소스를 검색하려면 id 쿼리 매개변수를 API 요청에서 이 값으로 설정합니다. |
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 메서드를 사용하여 이 값을 설정할 수 있습니다. |