ChannelBanners: 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ı temsil eder:

1. İ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.
2. 1. adımda API'nin döndürdüğü yanıttan url mülkünün değerini ayıklayın.
3. 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.

Bu yöntem, medya yüklemeyi destekler. Yüklenen dosyalar aşağıdaki kısıtlamalara uygun olmalıdır:

• Maksimum dosya boyutu: 6 MB
• Kabul edilen medya MIME türleri: image/jpeg, image/png, application/octet-stream

Kota etkisi: Bu yöntemin çağrısı 50 birim kota maliyetine sahiptir.

İstek

HTTP isteği

POST https://www.googleapis.com/upload/youtube/v3/channelBanners/insert

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az biri ile yetkilendirme gerekir. Kimlik doğrulama ve yetkilendirme hakkında daha fazla bilgi edinmek için OAuth 2.0 yetkilendirmesini uygulama başlıklı makaleyi inceleyin.

Kapsam
https://www.googleapis.com/auth/youtube.upload
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parametreler

Aşağıdaki tabloda, bu sorgunun desteklediği parametreler listelenmiştir. Listelenen tüm parametreler sorgu parametreleridir.

Parametreler
İsteğe bağlı parametreler
onBehalfOfContentOwner	string Bu parametre yalnızca uygun şekilde yetkilendirilmiş bir istekte kullanılabilir. Not: Bu parametre yalnızca YouTube içerik iş ortakları için tasarlanmıştır. onBehalfOfContentOwner parametresi, isteğin yetkilendirme kimlik bilgilerinin, parametre değerinde belirtilen içerik sahibi adına hareket eden bir YouTube içerik yönetim sistemi kullanıcısını tanımladığını gösterir. Bu parametre, birçok farklı YouTube kanalına sahip olan ve bu kanalları yöneten YouTube içerik iş ortakları için tasarlanmıştır. Bu sayede içerik sahipleri, her kanal için kimlik doğrulama kimlik bilgilerini sağlamak zorunda kalmadan tek seferde kimlik doğrulama yapabilir ve tüm video ve kanal verilerine erişebilir. Kullanıcının kimlik doğrulaması yaptığı İYS hesabı, belirtilen YouTube içerik sahibine bağlı olmalıdır.

İstek içeriği

Bu yöntemi çağırırken istek gövdesi sağlamaz.

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir channelBanner kaynağı döndürür.

Hatalar

Aşağıdaki tabloda, API'nin bu yönteme yapılan bir çağrıya yanıt olarak döndürebileceği hata mesajları tanımlanmaktadır. Daha fazla bilgi için YouTube Data API - Errors başlıklı makaleyi inceleyin.

Hata türü	Hata ayrıntısı	Açıklama
badRequest (400)	bannerAlbumFull	YouTube kanal resmi albümünüzde çok fazla resim var. Bu sorunu düzeltmek için Google Fotoğraflar'a gidin, ardından albümler sayfasına gidip albümden bazı resimleri kaldırın.
badRequest (400)	mediaBodyRequired	İstek, resim içeriğini içermiyor.

Deneyin!

Bu API'yi çağırmak ve API isteğini ve yanıtını görmek için APIs Explorer simgesini kullanın.