يحتوي مورد channelBanner على عنوان URL الذي ستستخدمه لضبط صورة تم تحميلها مؤخرًا كصورة بانر لقناة.
الطُرق
تتيح واجهة برمجة التطبيقات الطرق التالية لموارد channelBanners:
- إدراج
- تحميل صورة بانر للقناة على YouTube تمثّل هذه الطريقة أول خطوتَين من عملية من ثلاث خطوات لتعديل صورة البانر للقناة:
- استخدِم الطريقة
channelBanners.insertلتحميل بيانات الصورة الثنائية إلى YouTube. يجب أن تكون الصورة بنسبة عرض إلى ارتفاع 16:9 وألا يقلّ حجمها عن 2048 × 1152 بكسل. ننصحك بتحميل صورة بحجم 2560 بكسل × 1440 بكسل. - استخرِج قيمة السمة
urlمن الاستجابة التي تعرضها واجهة برمجة التطبيقات في الخطوة 1. - استخدِم الطريقة
channels.updateلتعديل إعدادات العلامة التجارية للقناة. اضبط قيمة السمةbrandingSettings.image.bannerExternalUrlعلى عنوان URL الذي تم الحصول عليه في الخطوة 2.
- استخدِم الطريقة
تمثيل الموارد
تعرض بنية JSON التالية تنسيق مورد channelBanners:
{
"kind": "youtube#channelBannerResource",
"etag": etag,
"url": string
}الخصائص
يحدِّد الجدول التالي السمات التي تظهر في هذا المرجع:
| الخصائص | |
|---|---|
kind |
stringلتحديد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#channelBannerResource. |
etag |
etagرقم تعريف Etag لهذا المورد. |
url |
stringعنوان URL لصورة البانر بعد استدعاء الطريقة channelBanners.insert، استخرِج هذه القيمة من استجابة واجهة برمجة التطبيقات. بعد ذلك، استخدِم طريقة channels.update واضبط عنوان URL كقيمة للسمة brandingSettings.image.bannerExternalUrl لضبط صورة البانر لقناة معيّنة. |