ChannelSections

يحتوي مورد 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 نوع قسم القناة. القيم الصالحة لهذه السمة هي: allPlaylists completedEvents liveEvents multipleChannels multiplePlaylists popularUploads recentUploads singlePlaylist subscriptions upcomingEvents
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، ويجب عدم تحديد هذه السمة لأنواع أخرى من الأقسام. لا يمكنك تضمين قناتك الخاصة في القائمة.