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