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