Playlists

playlist 리소스는 YouTube 재생목록을 나타냅니다. 재생목록은 순서대로 감상하거나 다른 사용자와 공유할 수 있는 동영상의 모음입니다. 재생목록은 최대 200개의 동영상을 포함할 수 있으며 사용자가 만들 수 있는 재생목록의 수에는 제한이 없습니다. 재생목록은 기본적으로 다른 사용자에게 공개되지만 비공개로 설정할 수도 있습니다.

YouTube 재생목록은 다음과 같은 채널의 특별한 동영상 모음을 구분합니다.

  • 업로드한 동영상
  • 즐겨찾는 동영상
  • 긍정적 평가(좋아요)를 받은 동영상
  • 감상한 동영상
  • 나중에 볼 동영상
보다 구체적으로 이러한 목록은 개인, 그룹 또는 회사의 동영상, 재생목록 및 기타 YouTube 정보의 모음인 채널과 연결되어 있습니다. 각 목록의 재생목록 ID는 해당 채널의 channel resource 리소스로부터 검색할 수 있습니다.

그런 다음 playlistItems.list 메소드를 사용해 원하는 목록을 검색합니다. playlistItems.insertplaylistItems.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
유효한 키 값은 다음과 같습니다.
  • default – 기본 미리보기 이미지입니다. 동영상에 대한 기본 미리보기 이미지 또는 재생목록 항목이나 검색결과 등 동영상을 참조하는 리소스이며 120x90픽셀입니다. 채널의 기본 미리보기 이미지는 88x88픽셀입니다.
  • medium – 미리보기 이미지의 중간 해상도 버전입니다. 동영상 또는 동영상을 참조하는 리소스의 경우 이 이미지는 320x180픽셀입니다. 채널의 경우 이 이미지는 240x240픽셀입니다.
  • high – 미리보기 이미지의 고해상도 버전입니다. 동영상 또는 동영상을 참조하는 리소스의 경우 이 이미지는 480x360픽셀입니다. 채널의 경우 이 이미지는 800x800픽셀입니다.
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
재생목록의 개인정보 보호 상태입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • private
  • public
  • unlisted
contentDetails object
contentDetails 개체는 재생목록의 동영상 수 등 재생목록 콘텐츠에 대한 정보를 포함합니다.
contentDetails.itemCount unsigned integer
재생목록의 동영상 수입니다.
player object
player 개체는 내장 플레이어에서 재생목록을 재생하기 위해 사용하려는 정보를 포함합니다.
player.embedHtml string
재생목록을 재생하는 플레이어를 삽입하는 <iframe> 태그입니다.