ChannelBanners

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

방법

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

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

  1. channelBanners.insert 메서드를 호출하여 바이너리 이미지 데이터를 YouTube에 업로드합니다. 이미지는 가로세로 비율이 16:9이며 2048x1152픽셀 이상이어야 합니다. 2560x1440픽셀 이미지를 업로드하는 것이 좋습니다.
  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을 설정하여 채널의 배너 이미지를 설정합니다.