이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Playlists

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

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

업로드한 동영상
긍정적 평가(좋아요)를 받은 동영상

더 구체적으로 말하면 이러한 목록은 개인, 그룹 또는 회사의 동영상, 재생목록, 기타 YouTube 정보의 모음인 채널과 연결됩니다. 각 목록의 재생목록 ID는 특정 채널의 channel resource에서 가져올 수 있습니다.

그런 다음 playlistItems.list 메서드를 사용하여 이러한 목록을 가져올 수 있습니다. playlistItems.insert 및 playlistItems.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` - 기본 썸네일 이미지입니다. 동영상 또는 재생목록 항목이나 검색 결과와 같이 동영상을 참조하는 리소스의 기본 썸네일은 120x90픽셀입니다. 채널의 기본 미리보기 이미지는 88x88픽셀입니다. `medium` - 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이 이미지는 320x180픽셀입니다. 채널의 경우 이 이미지는 240x240픽셀입니다. `high` - 썸네일 이미지의 고해상도 버전입니다. 동영상 (또는 동영상을 참조하는 리소스)의 경우 이 이미지는 480x360픽셀입니다. 채널의 경우 이 이미지는 800x800픽셀입니다. `standard` - `high` 해상도 이미지보다 더 높은 해상도 버전의 썸네일 이미지입니다. 이 이미지는 동영상을 참조하는 일부 동영상 및 기타 리소스(예: 재생목록 항목 또는 검색 결과)에 사용할 수 있습니다. 이 이미지는 640x480픽셀입니다. `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.title` 및 `snippet.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` 재생목록의 공개 범위 설정 상태입니다. 이 속성에 유효한 값은 다음과 같습니다. <ph type="x-smartling-placeholder"> </ph> `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` 현지화된 재생목록 설명입니다.