يتضمّن مورد 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 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 ، ويجب عدم تحديد هذه الخاصية لأنواع أخرى من الأقسام. لا يمكنك تضمين قناتك في القائمة. |