ChannelSections

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

채널 하나당 최대 10개의 섹션을 만들 수 있습니다.

방법

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

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

리소스 표현

다음 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 목록을 지정해야 하며 이 속성을 다른 유형의 섹션에 지정해서는 안 됩니다. 목록에 자신의 채널을 포함할 수 없습니다.