ChannelBanners

يحتوي مورد channelBanner على عنوان URL الذي ستستخدمه لضبط صورة تم تحميلها مؤخرًا كصورة بانر لقناة.

الطُرق

تتيح واجهة برمجة التطبيقات الطرق التالية لموارد channelBanners:

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