ChannelBanners

یک منبع channelBanner حاوی URL است که می‌توانید از آن برای تنظیم یک تصویر جدید آپلود شده به عنوان تصویر بنر یک کانال استفاده کنید.

روش ها

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

insert

یک تصویر بنر کانال را در YouTube آپلود می کند. این روش نشان دهنده دو مرحله اول در یک فرآیند سه مرحله ای برای به روز رسانی تصویر بنر برای یک کانال است:

1. با روش channelBanners.insert تماس بگیرید تا داده های تصویر باینری را در YouTube آپلود کنید. تصویر باید دارای نسبت تصویر 16:9 و حداقل 2048x1152 پیکسل باشد. توصیه می کنیم یک تصویر 2560 در 1440 پیکسل را آپلود کنید.
2. مقدار ویژگی url را از پاسخی که API برای مرحله 1 برمی‌گرداند استخراج کنید.
3. برای به روز رسانی تنظیمات نام تجاری کانال، با روش channels.update تماس بگیرید. مقدار ویژگی brandingSettings.image.bannerExternalUrl را روی URL بدست آمده در مرحله 2 تنظیم کنید.

نمایندگی منابع

ساختار JSON زیر فرمت یک منبع channelBanners را نشان می دهد:

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

خواص

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

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