ChannelBanners

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

메서드

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

insert
YouTube에 채널 배너 이미지를 업로드합니다. 이 메서드는 채널의 배너 이미지를 업데이트하는 3단계 프로세스의 처음 두 단계를 나타냅니다.
  1. channelBanners.insert 메서드를 호출하여 바이너리 이미지 데이터를 YouTube에 업로드합니다. 이미지의 가로세로 비율은 16:9여야 하며, 크기는 2048x1152픽셀 이상이어야 합니다. 2560x1440픽셀 이미지를 업로드하는 것이 좋습니다.
  2. 1단계에서 API가 반환하는 응답에서 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 메서드를 호출하고 URL을 brandingSettings.image.bannerExternalUrl 속성의 값으로 설정하여 채널의 배너 이미지를 설정합니다.