ChannelBanners

channelBanner 리소스에는 새로 업로드한 이미지를 채널의 배너 이미지로 설정하는 데 사용할 URL이 포함되어 있습니다.

메소드

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

insert

YouTube에 채널 배너 이미지를 업로드합니다. 이 메소드는 다음과 같이 채널의 배너 이미지를 업데이트하는 3단계 절차 중 처음 두 단계를 나타냅니다.

1. channelBanners.insert 메소드를 호출하여 YouTube에 바이너리 이미지를 업로드합니다. 이미지는 화면 비율이 16:9여야 하며 최소 2120x1192픽셀 이상이어야 합니다.
2. API가 1단계에서 반환한 응답으로부터 url 속성 값을 추출합니다.
3. channels.update 메소드를 호출해 채널의 브랜드 설정을 업데이트합니다. brandingSettings.image.bannerExternalUrl 속성 값을 2단계에서 확인한 URL로 설정합니다.

리소스 표현

아래의 JSON 구조는 channelBanners 리소스의 형식을 보여줍니다.

{
  "kind": "youtube#channelBannerResource",
  "etag": etag,
  "url": string
}

속성

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

속성 이름
kind	string API 리소스의 유형입니다. 값은 youtube#channelBannerResource가 됩니다.
etag	etag 이 리소스의 Etag입니다.
url	string 배너 이미지의 URL입니다. channelBanners.insert 메소드를 호출한 후 API 응답에서 이 값을 추출합니다. 그런 다음 channels.update 메소드를 호출하고 brandingSettings.image.bannerExternalUrl 속성의 값으로 URL을 설정하여 채널에 배너 이미지를 설정합니다.