ChannelSections

منبع channelSection حاوی اطلاعاتی درباره مجموعه‌ای از ویدیوها است که کانال برای نمایش انتخاب کرده است. برای مثال، یک بخش می‌تواند شامل جدیدترین بارگذاری‌های کانال، محبوب‌ترین بارگذاری‌ها، یا ویدیوهای یک یا چند فهرست پخش باشد.

هر کانال می‌تواند حداکثر ۱۰ قفسه ایجاد کند.

روش‌ها

این میانای برنامه‌سازی کاربردی از روش‌های زیر برای منابع channelSections پشتیبانی می‌کند:

فهرست
فهرستی از منابع channelSection را که با معیارهای درخواست API مطابقت دارند برمی‌گرداند. اکنون امتحان کنید.
درج کردن
بخش کانال را به کانال کاربر اصالت‌سنجی‌شده اضافه می‌کند. هر کانال می‌تواند حداکثر ۱۰ قفسه ایجاد کند. اکنون امتحان کنید.
به‌روزرسانی
بخش کانال را به‌روز می‌کند. اکنون امتحان کنید.
حذف
بخش کانال را حذف می‌کند. اکنون امتحان کنید.

نمایش منبع

ساختار 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 باشد، و درواقع، هنگام درج یا به‌روزرسانی هریک از این انواع بخش‌ها باید عنوان را مشخص کنید. اگر عنوانی برای انواع دیگر بخش‌های کانال مشخص کنید، مقدار نادیده گرفته خواهد شد.

مقدار این ویژگی حداکثر ۱۰۰ نویسه طول دارد و می‌تواند شامل تمام نویسه‌های معتبر UTF-8 به‌جز < و > باشد.
snippet.position unsigned integer
موقعیت بخش در صفحه کانال. این ویژگی از نمایه مبتنی بر ۰ استفاده می‌کند. مقدار 0 اولین بخشی را که در کانال ظاهر می‌شود شناسایی می‌کند، مقدار 1 بخش دوم را شناسایی می‌کند، و غیره.

اگر هنگام درج بخش کانال، مقداری برای این ویژگی مشخص نکنید، رفتار پیش‌فرض این است که بخش جدید در آخر نمایش داده شود.
contentDetails object
شیء contentDetails حاوی جزئیاتی درباره محتوای بخش کانال است، مانند فهرستی از فهرست‌های پخش یا کانال‌های ویژه در بخش.
contentDetails.playlists[] list
فهرستی از یک یا چند شناسه فهرست پخش که در بخش کانال ویژه شده‌اند. اگر ویژگی snippet.type منبع channelSection singlePlaylist یا multiplePlaylists باشد، باید فهرستی از شناسه‌های فهرست پخش را مشخص کنید و این ویژگی نباید برای انواع دیگر بخش‌ها مشخص شود. اگر نوع singlePlaylist باشد، این فهرست باید دقیقاً یک شناسه فهرست پخش را مشخص کند.
contentDetails.channels[] list
فهرستی از یک یا چند شناسه کانال که در بخش کانال ویژه شده‌اند. اگر ویژگی snippet.type منبع channelSection برابر با multipleChannels باشد، باید فهرستی از شناسه‌های کانال را مشخص کنید و این ویژگی نباید برای انواع دیگر بخش‌ها مشخص شود. نمی‌توانید کانال خودتان را در فهرست قرار دهید.