channelBanner kaynağı, yeni yüklenen bir resmi bir kanalın banner resmi olarak ayarlamak için kullanacağınız URL'yi içerir.
Yöntemler
API, channelBanners kaynakları için aşağıdaki yöntemleri destekler:
- insert
- YouTube'a kanal banner'ı resmi yükler. Bu yöntem, bir kanalın banner resmini güncellemeyle ilgili üç adımlı sürecin ilk iki adımını gösterir:
- İkili görüntü verilerini YouTube'a yüklemek için
channelBanners.insertyöntemini çağırın. Resim en boy oranı 16:9 ve en az 2048x1152 piksel olmalıdır. 2560 piksel x 1440 piksel boyutunda bir resim yüklemenizi öneririz. - 1. adımda API'nin döndürdüğü yanıttan
urlmülkünün değerini çıkarın. - Kanalın marka öğelerini güncellemek için
channels.updateyöntemini çağırın.brandingSettings.image.bannerExternalUrlmülkünün değerini 2. adımda elde edilen URL olarak ayarlayın.
- İkili görüntü verilerini YouTube'a yüklemek için
Kaynak temsili
Aşağıdaki JSON yapısında, channelBanners kaynağının biçimi gösterilmektedir:
{
"kind": "youtube#channelBannerResource",
"etag": etag,
"url": string
}Özellikler
Aşağıdaki tabloda bu kaynakta görünen özellikler tanımlanmaktadır:
| Özellikler | |
|---|---|
kind |
stringAPI kaynağının türünü tanımlar. Değer youtube#channelBannerResource olur. |
etag |
etagBu kaynağın Etag değeri. |
url |
stringBanner resminin URL'si. channelBanners.insert yöntemini çağırdıktan sonra bu değeri API yanıtından ayıklayın. Ardından, bir kanalın banner resmini ayarlamak için channels.update yöntemini çağırın ve URL'yi brandingSettings.image.bannerExternalUrl mülkünün değeri olarak ayarlayın. |