channelSection
리소스에는 채널에서 추천하도록 선택한 동영상 모음에 대한 정보가 포함됩니다. 예를 들어 섹션에 채널의 최신 업로드, 가장 인기 있는 업로드 또는 하나 이상의 재생목록에 있는 동영상을 표시할 수 있습니다.
채널 하나당 최대 10개의 섹션을 만들 수 있습니다.
방법
API는 channelSections
리소스에 다음 메서드를 지원합니다.
리소스 표현
다음 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 채널 섹션의 유형입니다. 이 속성에 유효한 값은 다음과 같습니다.
|
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 목록을 지정해야 하며 이 속성을 다른 유형의 섹션에 지정해서는 안 됩니다. 목록에 자신의 채널을 포함할 수 없습니다. |