ChannelBanners
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يحتوي مورد 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 لضبط صورة البانر لقناة معيّنة. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-12-21 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-12-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The `channelBanner` resource provides the URL needed to set a newly uploaded image as a channel's banner image."],["Updating a channel banner image involves a three-step process, starting with uploading the image using the `channelBanners.insert` method."],["The uploaded banner image must have a 16:9 aspect ratio and be at least 2048x1152 pixels, with 2560x1440 recommended."],["After uploading, the `url` property from the API response is extracted, and then used in the `channels.update` method, specifically in the `brandingSettings.image.bannerExternalUrl` property, to set the banner image."],["The `channelBanners` resource contains `kind`, `etag`, and `url` properties, with the `url` property holding the banner image's URL."]]],["The `channelBanner` resource provides a URL for setting a channel's banner image. Updating a banner involves three steps: first, use `channelBanners.insert` to upload an image (16:9 aspect ratio, at least 2048x1152 pixels). Second, extract the `url` from the response. Third, use `channels.update`, setting `brandingSettings.image.bannerExternalUrl` to the extracted URL. The resource includes `kind` (`youtube#channelBannerResource`), `etag`, and the banner image's `url`.\n"]]
