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