يحتوي مورد channelSection
على معلومات حول مجموعة
الفيديوهات التي اختارت القناة إبرازها. على سبيل المثال، يمكن أن يعرض القسم الفيديوهات الأخيرة التي حمّلتها إلى قناة معيّنة أو الفيديوهات الأكثر رواجًا أو فيديوهات من قائمة تشغيل واحدة أو أكثر.
يمكن للقناة إنشاء 10 رفوف كحد أقصى.
الطُرق
تتيح واجهة برمجة التطبيقات استخدام الطرق التالية لموارد channelSections
:
- list
- عرض قائمة من
channelSection
مورد تتطابق مع معايير طلب واجهة برمجة التطبيقات. التجربة الآن - إدراج
- لإضافة قسم قناة إلى قناة المستخدم الذي تمت المصادقة عليه. يمكن للقناة إنشاء 10 رفوف كحد أقصى. التجربة الآن
- تعديل
- تعديل قسم في القناة التجربة الآن
- حذف
- حذف قسم في القناة التجربة الآن
تمثيل الموارد
تعرض بنية JSON التالية تنسيق مورد channelSections
:
{ "kind": "youtube#channelSection", "etag": etag, "id": string, "snippet": { "type": string, "channelId": string, "title": string, "position": unsigned integer }, "contentDetails": { "playlists": [ string ], "channels": [ string ] } }
أماكن إقامة
يحدد الجدول التالي الخصائص التي تظهر في هذا المورد:
أماكن إقامة | |
---|---|
kind |
string يحدّد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#channelSection . |
etag |
etag علامة هذا المرجع. |
id |
string المعرّف الذي تستخدمه YouTube لتحديد قسم القناة بشكل فريد. |
snippet |
object يحتوي الكائن snippet على تفاصيل أساسية حول قسم القناة، مثل نوعه وعنوانه. |
snippet.type |
string نوع قسم القناة. القيم الصالحة لهذه السمة هي:
|
snippet.channelId |
string المعرّف الذي تستخدمه YouTube لتحديد القناة التي نشرت قسم القناة بشكل فريد. |
snippet.title |
string عنوان القسم. يمكنك فقط ضبط عنوان قسم في القناة يتضمّن القيمة snippet.type إما multiplePlaylists أو multipleChannels ، ويجب تحديد العنوان عند إدراج أو تعديل أحد هذين النوعين من الأقسام. إذا حدّدت عنوانًا لأنواع أخرى من أقسام القناة، سيتم تجاهل القيمة.يبلغ الحد الأقصى لطول قيمة هذه السمة 100 حرف، وقد تحتوي على جميع أحرف UTF-8 الصالحة باستثناء < و>. |
snippet.position |
unsigned integer موضع القسم على صفحة القناة يستخدم هذا الموقع فهرسًا مستندًا إلى 0. تحدد القيمة 0 القسم الأول الذي يظهر على القناة، وتحدد القيمة 1 القسم الثاني، وهكذا.إذا لم تحدّد قيمة لهذه السمة عند إدراج قسم في القناة، سيكون السلوك التلقائي هو عرض القسم الجديد في النهاية. |
contentDetails |
object يحتوي العنصر contentDetails على تفاصيل حول محتوى قسم القناة، مثل قائمة بقوائم التشغيل أو القنوات المعروضة في القسم. |
contentDetails.playlists[] |
list قائمة بمعرّف واحد أو أكثر لقائمة تشغيل معروضة في قسم من أقسام القناة يجب تحديد قائمة بأرقام تعريف قوائم التشغيل إذا كانت السمة snippet.type في مورد channelSection إما singlePlaylist أو multiplePlaylists ، ويجب عدم تحديد هذه السمة لأنواع أخرى من الأقسام. إذا كان النوع singlePlaylist ، يجب أن تحدّد هذه القائمة معرّف قائمة تشغيل واحدًا فقط. |
contentDetails.channels[] |
list قائمة بمعرّف قناة واحد أو أكثر يظهر في قسم معيّن من القناة يجب تحديد قائمة بمعرّفات القنوات إذا كانت السمة snippet.type في مورد channelSection هي multipleChannels ، ويجب عدم تحديد هذه السمة لأنواع أخرى من الأقسام. لا يمكنك تضمين قناتك الخاصة في القائمة. |