ChannelSections

channelSection 리소스에는 채널에서 추천하기로 선택한 동영상 모음에 대한 정보가 포함됩니다. 예를 들어 섹션에는 채널의 최신 업로드, 가장 인기 있는 업로드, 하나 이상의 재생목록에서 가져온 동영상이 포함될 수 있습니다.

한 채널에 최대 10개의 서가를 만들 수 있습니다.

방법

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

list
API 요청 기준과 일치하는 channelSection 리소스 목록을 반환합니다. 지금 사용해 보기
삽입
인증된 사용자의 채널에 채널 섹션을 추가합니다. 한 채널에 최대 10개의 서가를 만들 수 있습니다. 지금 사용해보기
업데이트
채널 섹션을 업데이트합니다. 지금 사용해보기
delete
채널 섹션을 삭제합니다. 지금 사용해보기

리소스 표현

다음 JSON 구조는 channelSections 리소스의 형식을 보여줍니다.

{
  "kind": "youtube#channelSection",
  "etag": etag,
  "id": string,
  "snippet": {
    "type": string,
    "channelId": string,
    "title": string,
    "position": unsigned integer
  },
  "contentDetails": {
    "playlists": [
      string
    ],
    "channels": [
      string
    ]
  }
}

속성

다음 표는 이 리소스에 표시되는 속성을 정의합니다.

속성
kind string
API 리소스의 유형을 식별합니다. 값은 youtube#channelSection입니다.
etag etag
이 리소스의 Etag입니다.
id string
YouTube가 채널 섹션을 고유하게 식별하는 데 사용하는 ID입니다.
snippet object
snippet 객체에는 유형 및 제목과 같은 채널 섹션에 관한 기본 세부정보가 포함되어 있습니다.
snippet.type string
채널 섹션의 유형입니다.

이 속성에 유효한 값은 다음과 같습니다.
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
snippet.channelId string
YouTube에서 채널 섹션을 게시한 채널을 고유하게 식별하는 데 사용하는 ID입니다.
snippet.title string
섹션의 제목입니다. snippet.type 값이 multiplePlaylists 또는 multipleChannels인 채널 섹션의 제목만 설정할 수 있으며, 실제로 이러한 유형의 섹션을 삽입하거나 업데이트할 때는 제목을 지정해야 합니다. 다른 유형의 채널 섹션에 제목을 지정하면 값이 무시됩니다.

이 속성 값의 최대 길이는 100자(영문 기준)이며 < 및 >을 제외한 모든 유효한 UTF-8 문자를 포함할 수 있습니다.
snippet.position unsigned integer
채널 페이지에서의 위치입니다. 이 속성은 0부터 시작하는 색인을 사용합니다. 값 0은 채널에 표시되는 첫 번째 섹션을 나타내며 1 값은 두 번째 섹션을 식별하는 식입니다.

채널 섹션을 삽입할 때 이 속성 값을 지정하지 않으면 기본적으로 새 섹션이 표시됩니다.
contentDetails object
contentDetails 객체에는 섹션에 포함된 재생목록이나 채널 목록 등 채널 섹션의 콘텐츠에 대한 세부정보가 포함되어 있습니다.
contentDetails.playlists[] list
채널 섹션에 표시되는 하나 이상의 재생목록 ID 목록입니다. channelSection 리소스의 snippet.type 속성이 singlePlaylist 또는 multiplePlaylists인 경우 재생목록 ID 목록을 지정해야 하며, 다른 유형의 섹션에 이 속성을 지정해서는 안 됩니다. 유형이 singlePlaylist인 경우 이 목록에서 재생목록 ID를 정확히 하나만 지정해야 합니다.
contentDetails.channels[] list
채널 섹션에 표시되는 하나 이상의 채널 ID 목록입니다. channelSection 리소스의 snippet.type 속성이 multipleChannels인 경우 채널 ID 목록을 지정해야 하며, 다른 유형의 섹션에 이 속성을 지정해서는 안 됩니다. 목록에 자신의 채널을 포함할 수 없습니다.