ChannelBanners
Stay organized with collections
Save and categorize content based on your preferences.
A
channelBanner
resource contains the URL that you would use to set a newly uploaded image as the banner image for a channel.
Methods
The API supports the following methods for
channelBanners
resources:
- insert
- Uploads a channel banner image to YouTube. This method represents the first two steps in a three-step process to update the banner image for a channel:
- Call the
channelBanners.insert
method to upload the binary image data to YouTube. The image must have a 16:9 aspect ratio and be at least 2048x1152 pixels. We recommend uploading a 2560px by 1440px image.
- Extract the
url
property's value from the response that the API returns for step 1.
- Call the
channels.update
method to update the channel's branding settings. Set the
brandingSettings.image.bannerExternalUrl
property's value to the URL obtained in step 2.
Resource representation
The following JSON structure shows the format of a
channelBanners
resource:
{
"
kind
": "youtube#channelBannerResource",
"
etag
":
etag
,
"
url
":
string
}
Properties
The following table defines the properties that appear in this resource:
Properties
|
kind
|
string
Identifies the API resource's type. The value will be
youtube#channelBannerResource
.
|
etag
|
etag
The Etag of this resource.
|
url
|
string
The banner image's URL. After calling the
channelBanners.insert
method, extract this value from the API response. Then call the
channels.update
method, and set the URL as the value of the
brandingSettings.image.bannerExternalUrl
property to set the banner image for a channel.
|
Except as otherwise noted, the content of this page is licensed under the
Creative Commons Attribution 4.0 License
, and code samples are licensed under the
Apache 2.0 License
. For details, see the
Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2022-11-04 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Missing the information I need"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Too complicated / too many steps"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Out of date"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Samples / code issue"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]