ChannelSections

משאב channelSection מכיל מידע על קבוצה של סרטונים שערוץ מסוים בחר להציג. לדוגמה, מדור יכול לכלול את ההעלאות האחרונות של הערוץ, ההעלאות הפופולריות ביותר או סרטונים מפלייליסט אחד או יותר.

ניתן ליצור עד 10 מדפים בערוץ.

שיטות

ה-API תומך בשיטות הבאות עבור משאבי channelSections:

list

מחזיר רשימה של channelSection משאבים שתואמים לקריטריונים של בקשת ה-API. כדאי לנסות עכשיו.

הוספה

הוספת מדור לערוץ של המשתמש המאומת. לערוץ יכולים להיות 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 מזהה את סוג המשאב של ה-API. הערך יהיה 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 רשימה של מזהי פלייליסטים אחד או יותר שמוצגים בקטע 'ערוצים'. עליך לציין רשימה של מזהי פלייליסטים אם מאפיין המשאב של channelSection ב-snippet.type הוא singlePlaylist או multiplePlaylists, ואין לציין את המאפיין הזה בסוגים אחרים של מדורים. אם הסוג הוא singlePlaylist, הרשימה חייבת לציין מזהה פלייליסט אחד בדיוק.
contentDetails.channels[]	list רשימה של מזהי ערוצים אחד או יותר שמוצגים בקטע 'ערוץ'. עליך לציין רשימה של מזהי ערוצים אם המאפיין snippet.type של המשאב channelSection הוא multipleChannels, ואין לציין את המאפיין הזה עבור סוגי מדורים אחרים. אי אפשר לכלול ערוץ משלך ברשימה.