ChannelSections

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

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

روش ها

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

list
فهرستی از منابع channelSection را برمی‌گرداند که با معیارهای درخواست API مطابقت دارند. اکنون آن را امتحان کنید .
insert
یک بخش کانال را به کانال کاربر تأیید شده اضافه می کند. یک کانال می تواند حداکثر 10 قفسه ایجاد کند. اکنون آن را امتحان کنید .
update
یک بخش کانال را به روز می کند. اکنون آن را امتحان کنید .
delete
بخش کانال را حذف می کند. اکنون آن را امتحان کنید .

نمایندگی منابع

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