ChannelBanners: insert

لتحميل صورة بانر للقناة إلى YouTube. تمثل هذه الطريقة أول خطوتين في عملية من ثلاث خطوات لتحديث صورة البانر لقناة:

1. عليك استدعاء طريقة channelBanners.insert لتحميل بيانات الصورة الثنائية إلى YouTube. يجب أن تكون للصورة نسبة عرض إلى ارتفاع تبلغ 16:9 وألا يقل حجمها عن 2048×1152 بكسل. نوصي بتحميل صورة بحجم 2560 بكسل × 1440 بكسل.
2. استخرِج قيمة الخاصية url من الاستجابة التي تعرضها واجهة برمجة التطبيقات للخطوة 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 المختلفة. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى كل بيانات الفيديو والقناة بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب ربط حساب نظام إدارة المحتوى الذي يصادق المستخدم عليه بمالك محتوى YouTube المحدد.

نص الطلب

لا تقدِّم نص طلب عند طلب هذه الطريقة.

الإجابة

وفي حال نجاحها، تعرض هذه الطريقة مورد بانر القناة في نص الاستجابة.

الأخطاء

يحدد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على استدعاء لهذه الطريقة. يرجى الاطلاع على وثائق رسالة الخطأ لمزيد من التفاصيل.

نوع الخطأ	تفاصيل الخطأ	الوصف
badRequest (400)	bannerAlbumFull	يحتوي ألبوم صورة القناة في YouTube على صور كثيرة جدًا. يُرجى الانتقال إلى http://photos.google.com، والانتقال إلى صفحة الألبومات، وإزالة بعضها من الصور من هذا الألبوم.
badRequest (400)	mediaBodyRequired	لا يتضمن الطلب محتوى الصورة.

جرِّب هذه الميزة الآن.

يمكنك استخدام APIs Explorer لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.