تصویر برنمای کانال را در YouTube بارگذاری می‌کند. این روش دو مرحله اول از یک فرایند سه مرحله‌ای برای به‌روزرسانی تصویر برنمای کانال را نشان می‌دهد:
- برای بارگذاری داده‌های تصویر دودویی در YouTube، روش
channelBanners.insertرا فراخوانی کنید. تصویر باید نسبت ابعادی ۱۶:۹ داشته باشد و حداقل ۲۰۴۸x۱۱۵۲ پیکسل باشد. توصیه می‌کنیم تصویری با ابعاد ۲۵۶۰ پیکسل در ۱۴۴۰ پیکسل بارگذاری کنید. - مقدار ویژگی
urlرا از پاسخی که API برای مرحله ۱ برمی‌گرداند استخراج کنید. - برای به‌روزرسانی تنظیمات نمانام‌سازی کانال، روش
channels.updateرا فراخوانی کنید. مقدار ویژگیbrandingSettings.image.bannerExternalUrlرا روی نشانی وب به‌دست‌آمده در مرحله ۲ تنظیم کنید.
این روش از بارگذاری رسانه پشتیبانی می‌کند. فایل‌های بارگذاری‌شده باید با این محدودیت‌ها مطابقت داشته باشند:
- حداکثر اندازه فایل: ۶ مگابایت
- انواع MIME رسانه پذیرفته‌شده:
image/jpeg،image/png،application/octet-stream
تأثیر سهمیه: فراخوانی این روش هزینه سهمیه ۵۰ واحدی دارد.
درخواست
درخواست HTTP
POST https://www.googleapis.com/upload/youtube/v3/channelBanners/insert
صدور مجوز
این درخواست به مجوز با حداقل یکی از دامنه‌های زیر نیاز دارد. برای خواندن بیشتر درباره اصالت‌سنجی و صدور مجوز، پیاده‌سازی مجوز OAuth 2.0 را ببینید.
| حوزه |
|---|
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 نشان می‌دهد که اطلاعات کاربری مجاز درخواست، کاربر CMS YouTube را که ازطرف مالک محتوای مشخص‌شده در مقدار پارامتر اقدام می‌کند شناسایی می‌کند. این پارامتر برای شرکای محتوای YouTube است که مالک و مدیر کانال‌های مختلف YouTube هستند. این ویژگی به مالکان محتوا اجازه می‌دهد یک‌بار اصالت‌سنجی کنند و به همه داده‌های ویدیو و کانال خود دسترسی پیدا کنند، بدون اینکه نیاز باشد برای هر کانال به‌طور جداگانه اعتبارنامه‌های اصالت‌سنجی ارائه دهند. حساب CMS که کاربر با آن اصالت‌سنجی می‌کند باید به مالک محتوای YouTube مشخص‌شده پیوند داده شده باشد. |
|
متن درخواست
هنگام فراخوانی این روش، بدنه درخواست ارائه نکنید.
پاسخ
درصورت موفقیت، این روش منبع channelBanner را در بدنه پاسخ برمی‌گرداند.
خطاها
جدول زیر پیام‌های خطایی را که ممکن است «میانای برنامه‌سازی کاربردی» در پاسخ به فراخوانی این روش برگرداند مشخص می‌کند. برای جزئیات بیشتر، به YouTube Data API - Errors مراجعه کنید.
| نوع خطا | جزئیات خطا | شرح |
|---|---|---|
badRequest (400) |
bannerAlbumFull |
آلبوم «تصویر کانال YouTube» شما تعداد زیادی تصویر دارد. برای رفع این مشکل، به Google Photos بروید، سپس به صفحه آلبوم‌ها بروید و چند تصویر را از آن آلبوم بردارید. |
badRequest (400) |
mediaBodyRequired |
درخواست شامل محتوای تصویر نیست. |
امتحان کنید!
از APIs Explorer برای فراخوانی این API و دیدن درخواست و پاسخ API استفاده کنید.