ChannelBanners: insert

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

1. يمكنك استدعاء الطريقة channelBanners.insert لتحميل بيانات الصورة الثنائية إلى YouTube. يجب أن تكون نسبة العرض إلى الارتفاع للصورة 16:9 وألا تقلّ عن 2048x1152 بكسل. ننصحك بتحميل صورة بحجم 2560 × 1440 بكسل.
2. استخرِج قيمة السمة url من الردّ الذي تعرضه واجهة برمجة التطبيقات في الخطوة 1.
3. عليك استدعاء الإجراء "channels.update" لتعديل إعدادات العلامة التجارية للقناة. اضبط قيمة السمة brandingSettings.image.bannerExternalUrl على عنوان URL الذي حصلت عليه في الخطوة 2.

تتيح هذه الطريقة تحميل الوسائط. يجب أن تتوافق الملفات المحمَّلة مع القيود التالية:

• الحد الأقصى لحجم الملف: 6 ميغابايت
• أنواع MIME للوسائط المقبولة: image/jpeg وimage/png وapplication/octet-stream

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

الطلب

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

الإجابة

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

الأخطاء

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

تجربة

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