يحتوي مورد channelBanner على عنوان URL الذي ستستخدمه لضبط صورة محمَّلة حديثًا كصورة بانر لقناة.
الطُرق
تتيح واجهة برمجة التطبيقات استخدام الطرق التالية لموارد channelBanners:
- إدراج
- يحمِّل صورة بانر للقناة إلى YouTube. تمثّل هذه الطريقة أول خطوتَين في عملية من ثلاث خطوات لتعديل صورة البانر لقناة.
- يمكنك استدعاء الطريقة
channelBanners.insertلتحميل بيانات الصورة الثنائية إلى YouTube. يجب أن تكون نسبة العرض إلى الارتفاع للصورة 16:9 وألا تقلّ عن 2048x1152 بكسل. ننصحك بتحميل صورة بحجم 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علامة هذا المرجع. |
url |
stringعنوان URL لصورة إعلان البانر. بعد طلب الإجراء channelBanners.insert، استخرِج هذه القيمة من استجابة واجهة برمجة التطبيقات. بعد ذلك، يمكنك استدعاء الإجراء channels.update وضبط عنوان URL كقيمة للسمة brandingSettings.image.bannerExternalUrl لضبط صورة البانر للقناة. |