Playlists

playlist 리소스는 YouTube 재생목록을 나타냅니다. 재생목록은 순차적으로 시청하고 다른 사용자와 공유할 수 있는 동영상 모음입니다. 재생목록은 기본적으로 다른 사용자에게 공개되지만 비공개로 설정할 수도 있습니다.

YouTube는 재생목록을 사용하여 다음과 같은 채널의 특별한 동영상 모음을 식별하기도 합니다.

  • 업로드한 동영상
  • 긍정적 평가(좋아요)를 받은 동영상
좀 더 구체적으로 말하면 이러한 목록은 채널과 연결되어 있으며, 채널은 개인, 그룹 또는 회사의 동영상, 재생목록, 기타 YouTube 정보의 모음입니다. 지정된 채널의 channel resource에서 이러한 목록별 재생목록 ID를 가져올 수 있습니다.

그런 다음 playlistItems.list 메서드를 사용하여 이러한 목록을 검색할 수 있습니다. playlistItems.insertplaylistItems.delete 메서드를 호출하여 이러한 목록에서 항목을 추가하거나 삭제할 수도 있습니다.

메서드

API는 playlists 리소스에 대해 다음 메서드를 지원합니다.

list
API 요청 매개변수와 일치하는 재생목록 컬렉션을 반환합니다. 예를 들어 인증된 사용자가 보유한 전체 재생목록을 검색하거나, 고유 ID를 통해 하나 또는 여러 개의 재생목록을 검색할 수 있습니다. 지금 사용해보기
insert
재생목록을 만듭니다. 지금 사용해보기
업데이트
재생목록을 수정합니다. 예를 들어 재생목록의 제목, 설명, 개인정보 보호 상태를 변경할 수 있습니다. 지금 사용해보기
삭제
재생목록을 삭제합니다. 지금 사용해보기

리소스 표현

다음 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 string
API 리소스의 유형을 식별합니다. 값은 youtube#playlist입니다.
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 - 기본 썸네일 이미지입니다. 동영상 또는 동영상을 참조하는 리소스(예: 재생목록 항목 또는 검색 결과)의 기본 썸네일은 너비 120px, 높이 90px입니다. 채널의 기본 미리보기 이미지는 88x88픽셀입니다.
  • medium - 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이 이미지는 너비가 320px이고 높이가 180px입니다. 채널의 경우 이 이미지는 240x240픽셀입니다.
  • high - 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이 이미지는 너비가 480px이고 높이가 360px입니다. 채널의 경우 이 이미지는 800x800픽셀입니다.
  • standardhigh 해상도 이미지보다 훨씬 더 높은 해상도의 썸네일 이미지입니다. 이 이미지는 일부 동영상과 재생목록 항목, 검색 결과 등 동영상을 참조하는 기타 리소스에 사용할 수 있습니다. 이 이미지는 너비가 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.tags[] list
이 속성은 지원 중단되었습니다.

재생목록과 연결된 키워드 태그입니다.
snippet.defaultLanguage string
playlist 리소스의 snippet.titlesnippet.description 속성에 있는 텍스트의 언어입니다.
snippet.localized object
snippet.localized 객체에는 재생목록의 현지화된 제목과 설명 또는 재생목록 메타데이터의 기본 언어 제목이 포함됩니다.
  • playlists.list 요청에서 hl 매개변수를 사용하여 현지화된 텍스트가 반환되어야 하는 언어를 지정하고 해당 언어로 현지화된 텍스트를 사용할 수 있는 경우 현지화된 텍스트가 리소스 스니펫에 반환됩니다.
  • hl 매개변수 값이 지정되지 않거나 값이 지정되었지만 지정된 언어에 현지화된 메타데이터가 없는 경우 기본 언어의 메타데이터가 반환됩니다.
속성에 읽기 전용 값이 포함되어 있습니다. localizations 객체를 사용하여 현지화된 제목을 추가, 업데이트 또는 삭제합니다.
snippet.localized.title string
현지화된 재생목록 제목입니다.
snippet.localized.description string
현지화된 재생목록 설명입니다.
status object
status 객체에는 재생목록의 상태 정보가 포함됩니다.
status.privacyStatus string
재생목록의 공개 상태입니다.

이 속성의 유효한 값은 다음과 같습니다.
  • private
  • public
  • unlisted
status.podcastStatus string
재생목록의 팟캐스트 상태입니다. 값이 enabled이면 재생목록이 팟캐스트 프로그램으로 표시됩니다. 재생목록의 팟캐스트 상태를 enabled로 설정하려면 재생목록에 재생목록 이미지가 있어야 합니다.

이 속성의 유효한 값은 다음과 같습니다.
  • enabled
  • disabled
  • unspecified
contentDetails object
contentDetails 객체에는 재생목록의 동영상 수를 비롯한 재생목록 콘텐츠에 관한 정보가 포함되어 있습니다.
contentDetails.itemCount unsigned integer
재생목록의 동영상 수입니다.
player object
player 객체에는 삽입된 플레이어에서 재생목록을 재생하는 데 사용되는 정보가 포함됩니다.
player.embedHtml string
재생목록을 재생할 플레이어를 삽입하는 <iframe> 태그입니다.
localizations object
localizations 객체는 재생목록의 메타데이터 번역을 캡슐화합니다.
localizations.(key) object
키 값과 연결된 현지화된 텍스트의 언어입니다. 값은 BCP-47 언어 코드를 포함하는 문자열입니다.
localizations.(key).title string
현지화된 재생목록 제목입니다.
localizations.(key).description string
현지화된 재생목록 설명입니다.