channelBanner
리소스에는 새로 업로드한 이미지를 채널의 배너 이미지로 설정하는 데 사용할 URL이 포함되어 있습니다.
메소드
API는 channelBanners
리소스에 다음 메소드를 지원합니다.
- insert
- YouTube에 채널 배너 이미지를 업로드합니다. 이 메소드는 다음과 같이 채널의 배너 이미지를 업데이트하는 3단계 절차 중 처음 두 단계를 나타냅니다.
channelBanners.insert
메소드를 호출하여 YouTube에 바이너리 이미지를 업로드합니다. 이미지는 화면 비율이 16:9여야 하며 최소 2120x1192픽셀 이상이어야 합니다.- API가 1단계에서 반환한 응답으로부터
url
속성 값을 추출합니다. 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을 설정하여 채널에 배너 이미지를 설정합니다. |