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.insert
yö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
url
mülkünün değerini çıkarın. - Kanalın marka öğelerini güncellemek için
channels.update
yöntemini çağırın.brandingSettings.image.bannerExternalUrl
mü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 |
string API kaynağının türünü tanımlar. Değer youtube#channelBannerResource olur. |
etag |
etag Bu kaynağın Etag değeri. |
url |
string Banner 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. |