playlist
리소스는 YouTube 재생목록을 나타냅니다. 재생목록은 순서대로 감상하거나 다른 사용자와 공유할 수 있는 동영상의 모음입니다. 재생목록은 최대 200개의 동영상을 포함할 수 있으며 사용자가 만들 수 있는 재생목록의 수에는 제한이 없습니다. 재생목록은 기본적으로 다른 사용자에게 공개되지만 비공개로 설정할 수도 있습니다.
YouTube 재생목록은 다음과 같은 채널의 특별한 동영상 모음을 구분합니다.
- 업로드한 동영상
- 즐겨찾는 동영상
- 긍정적 평가(좋아요)를 받은 동영상
- 감상한 동영상
- 나중에 볼 동영상
channel resource
리소스로부터 검색할 수 있습니다.그런 다음
playlistItems.list
메소드를 사용해 원하는 목록을 검색합니다. playlistItems.insert
및 playlistItems.delete
메소드를 호출해 목록에 항목을 추가하거나 목록에서 항목을 삭제할 수도 있습니다.
메소드
API는 playlists
리소스에 다음 메소드를 지원합니다.
- list
- API 요청 매개변수와 일치하는 재생목록의 모음을 반환합니다. 예를 들어 인증된 사용자가 보유한 전체 재생목록을 검색하거나, 고유 ID를 통해 하나 또는 여러 개의 재생목록을 검색할 수 있습니다. 지금 사용해 보세요.
- insert
- 재생목록을 만듭니다. 지금 사용해 보세요.
- update
- 재생목록을 수정합니다. 예를 들어 재생목록의 제목, 설명, 개인정보 보호 상태를 변경할 수 있습니다. 지금 사용해 보세요.
- delete
- 재생목록을 삭제합니다. 지금 사용해 보세요.
리소스 표현
아래의 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, "tags": [ string ] }, "status": { "privacyStatus": string }, "contentDetails": { "itemCount": unsigned integer }, "player": { "embedHtml": string } }
속성
다음 표는 이 리소스에 표시되는 속성을 정의합니다.
속성 이름 | |
---|---|
kind |
string API 리소스의 유형입니다. 값은 youtube#playlist 가 됩니다. |
etag |
etag 이 리소스의 Etag입니다. |
id |
string YouTube가 재생목록을 고유하게 식별하는 데 사용하는 ID입니다. |
snippet |
object snippet 개체는 제목, 설명 등 재생목록에 대한 기본 세부정보를 포함합니다. |
snippet.publishedAt |
datetime 재생목록을 만든 날짜 및 시간입니다. 값은 ISO 8601( YYYY-MM-DDThh:mm:ss.sZ ) 형식으로 지정됩니다. |
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.tags[] |
list 재생목록에 관련된 키워드 태그입니다. |
status |
object status 개체는 재생목록에 대한 상태 정보를 포함합니다. |
status.privacyStatus |
string 재생목록의 개인정보 보호 상태입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
contentDetails |
object contentDetails 개체는 재생목록의 동영상 수 등 재생목록 콘텐츠에 대한 정보를 포함합니다. |
contentDetails.itemCount |
unsigned integer 재생목록의 동영상 수입니다. |
player |
object player 개체는 내장 플레이어에서 재생목록을 재생하기 위해 사용하려는 정보를 포함합니다. |
player.embedHtml |
string 재생목록을 재생하는 플레이어를 삽입하는 <iframe> 태그입니다. |