ChannelBanners

یک منبع channelBanner حاوی نشانی وبی است که برای تنظیم یک تصویر تازه بارگذاری‌شده به‌عنوان تصویر برنما برای یک کانال استفاده می‌کنید.

روش‌ها

میانای برنامه‌سازی کاربردی از روش‌های زیر برای منابع channelBanners پشتیبانی می‌کند:

درج
تصویر برنمای کانال را در YouTube بارگذاری می‌کند. این روش دو مرحله اول از یک فرایند سه مرحله‌ای برای به‌روزرسانی تصویر برنمای یک کانال را نشان می‌دهد:
  1. برای بارگذاری داده‌های تصویر دودویی در YouTube، روش channelBanners.insert را فراخوانی کنید. تصویر باید نسبت ابعادی ۱۶:۹ و حداقل ۲۰۴۸×۱۱۵۲ پیکسل داشته باشد. توصیه می‌کنیم تصویری با ابعاد ۲۵۶۰ پیکسل در ۱۴۴۰ پیکسل بارگذاری کنید.
  2. مقدار دارایی url را از پاسخی که «میانای برنامه‌سازی کاربردی» برای مرحله ۱ برمی‌گرداند استخراج کنید.
  3. برای به‌روزرسانی تنظیمات نمانام‌سازی کانال، روش channels.update را فراخوانی کنید. مقدار دارایی brandingSettings.image.bannerExternalUrl را روی نشانی وب به‌دست‌آمده در مرحله ۲ تنظیم کنید.

وکالت منابع

ساختار JSON زیر قالب منبع channelBanners را نشان می‌دهد:

{
  "kind": "youtube#channelBannerResource",
  "etag": etag,
  "url": string
}

مشخصات

جدول زیر ویژگی‌هایی را که در این منبع ظاهر می‌شوند تعریف می‌کند:

مشخصات
kind string
نوع منبع میانای برنامه‌سازی کاربردی را مشخص می‌کند. مقدار youtube#channelBannerResource خواهد بود.
etag etag
‫Etag این منبع.
url string
نشانی وب تصویر برنما. پس‌از فراخوانی روش channelBanners.insert، این مقدار را از پاسخ API استخراج کنید. سپس متد channels.update را فراخوانی کنید و نشانی وب را به‌عنوان مقدار دارایی brandingSettings.image.bannerExternalUrl تنظیم کنید تا تصویر برنمای کانال را تنظیم کنید.