ChannelBanners: insert

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

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

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

  • حداکثر حجم فایل: 6 مگابایت
  • انواع MIME رسانه پذیرفته شده: image/jpeg ، image/png ، application/octet-stream

تاثیر سهمیه ای: فراخوانی به این روش هزینه سهمیه ای 50 واحدی دارد.

درخواست

درخواست HTTP

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

مجوز

این درخواست به مجوز حداقل با یکی از حوزه های زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).

محدوده
https://www.googleapis.com/auth/youtube.upload
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

مولفه های

جدول زیر پارامترهایی را که این کوئری پشتیبانی می کند فهرست می کند. تمام پارامترهای لیست شده پارامترهای پرس و جو هستند.

مولفه های
پارامترهای اختیاری
onBehalfOfContentOwner string
این پارامتر فقط در یک درخواست مجاز به درستی قابل استفاده است. توجه: این پارامتر منحصراً برای شرکای محتوای YouTube در نظر گرفته شده است.

پارامتر onBehalfOfContentOwner نشان می‌دهد که اعتبارنامه مجوز درخواست، کاربر YouTube CMS را شناسایی می‌کند که از طرف مالک محتوا مشخص‌شده در مقدار پارامتر عمل می‌کند. این پارامتر برای شرکای محتوای YouTube در نظر گرفته شده است که کانال‌های مختلف YouTube را مالک و مدیریت می‌کنند. این به صاحبان محتوا اجازه می‌دهد تا یک بار احراز هویت کنند و به تمام داده‌های ویدیو و کانال خود دسترسی داشته باشند، بدون اینکه نیازی به ارائه اعتبارنامه احراز هویت برای هر کانال جداگانه داشته باشند. حساب CMS که کاربر با آن احراز هویت می‌کند باید به مالک محتوای YouTube مشخص شده مرتبط باشد.

درخواست بدن

هنگام فراخوانی این روش، بدنه درخواست ارائه نکنید.

واکنش

در صورت موفقیت آمیز بودن، این روش یک منبع channelBanner را در بدنه پاسخ برمی گرداند.

خطاها

جدول زیر پیام های خطایی را مشخص می کند که API می تواند در پاسخ به تماس با این روش بازگرداند. لطفاً برای جزئیات بیشتر به مستندات پیام خطا مراجعه کنید.

نوع خطا جزئیات خطا شرح
badRequest (400) bannerAlbumFull آلبوم هنری کانال YouTube شما تصاویر بسیار زیادی دارد. لطفاً به http://photos.google.com بروید، به صفحه آلبوم‌ها بروید و برخی از تصاویر را از آن آلبوم حذف کنید.
badRequest (400) mediaBodyRequired درخواست شامل محتوای تصویر نمی شود.

آن را امتحان کنید!

از APIs Explorer برای فراخوانی این API و مشاهده درخواست و پاسخ API استفاده کنید.