playlist 리소스는 YouTube 재생목록을 나타냅니다. 재생목록은 순차적으로 시청하고 다른 사용자와 공유할 수 있는 동영상 모음입니다. 재생목록은 기본적으로 다른 사용자에게 공개되지만 비공개로 설정할 수도 있습니다.
YouTube는 재생목록을 사용하여 다음과 같은 채널의 특별한 동영상 모음을 식별하기도 합니다.
- 업로드한 동영상
- 긍정적 평가(좋아요)를 받은 동영상
channel resource에서 이러한 목록별 재생목록 ID를 가져올 수 있습니다.그런 다음
playlistItems.list 메서드를 사용하여 이러한 목록을 검색할 수 있습니다. playlistItems.insert 및 playlistItems.delete 메서드를 호출하여 이러한 목록에서 항목을 추가하거나 삭제할 수도 있습니다.
메서드
API는 playlists 리소스에 대해 다음 메서드를 지원합니다.
리소스 표현
다음 JSON 구조에서 playlists 리소스의 형식을 보여줍니다.
{
"kind": "youtube#playlist",
"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,
"defaultLanguage": string,
"localized": {
"title": string,
"description": string
}
},
"status": {
"privacyStatus": string,
"podcastStatus": enum
},
"contentDetails": {
"itemCount": unsigned integer
},
"player": {
"embedHtml": string
},
"localizations": {
(key): {
"title": string,
"description": string
}
}
}속성
다음 표는 이 리소스에 표시되는 속성을 정의합니다.
| 속성 | |
|---|---|
kind |
stringAPI 리소스의 유형을 식별합니다. 값은 youtube#playlist입니다. |
etag |
etag이 리소스의 ETag입니다. |
id |
stringYouTube에서 재생목록을 고유하게 식별하는 데 사용하는 ID입니다. |
snippet |
objectsnippet 객체에는 재생목록의 제목, 설명과 같은 기본 세부정보가 포함됩니다. |
snippet.publishedAt |
datetime재생목록이 생성된 날짜 및 시간입니다. 값은 ISO 8601 형식으로 지정됩니다. |
snippet.channelId |
stringYouTube에서 재생목록을 게시한 채널을 고유하게 식별하는 데 사용하는 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.tags[] |
list이 속성은 지원 중단되었습니다. 재생목록과 연결된 키워드 태그입니다. |
snippet.defaultLanguage |
stringplaylist 리소스의 snippet.title 및 snippet.description 속성에 있는 텍스트의 언어입니다. |
snippet.localized |
objectsnippet.localized 객체에는 재생목록의 현지화된 제목과 설명 또는 재생목록 메타데이터의 기본 언어 제목이 포함됩니다.
localizations 객체를 사용하여 현지화된 제목을 추가, 업데이트 또는 삭제합니다. |
snippet.localized.title |
string현지화된 재생목록 제목입니다. |
snippet.localized.description |
string현지화된 재생목록 설명입니다. |
status |
objectstatus 객체에는 재생목록의 상태 정보가 포함됩니다. |
status.privacyStatus |
string재생목록의 공개 상태입니다. 이 속성의 유효한 값은 다음과 같습니다.
|
status.podcastStatus |
string재생목록의 팟캐스트 상태입니다. 값이 enabled이면 재생목록이 팟캐스트 프로그램으로 표시됩니다. 재생목록의 팟캐스트 상태를 enabled로 설정하려면 재생목록에 재생목록 이미지가 있어야 합니다.이 속성의 유효한 값은 다음과 같습니다.
|
contentDetails |
objectcontentDetails 객체에는 재생목록의 동영상 수를 비롯한 재생목록 콘텐츠에 관한 정보가 포함되어 있습니다. |
contentDetails.itemCount |
unsigned integer재생목록의 동영상 수입니다. |
player |
objectplayer 객체에는 삽입된 플레이어에서 재생목록을 재생하는 데 사용되는 정보가 포함됩니다. |
player.embedHtml |
string재생목록을 재생할 플레이어를 삽입하는 <iframe> 태그입니다. |
localizations |
objectlocalizations 객체는 재생목록의 메타데이터 번역을 캡슐화합니다. |
localizations.(key) |
object키 값과 연결된 현지화된 텍스트의 언어입니다. 값은 BCP-47 언어 코드를 포함하는 문자열입니다. |
localizations.(key).title |
string현지화된 재생목록 제목입니다. |
localizations.(key).description |
string현지화된 재생목록 설명입니다. |