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 ה-e של המשאב הזה.
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, ואין לציין את המאפיין הזה לסוגים אחרים של קטעים. לא ניתן לכלול את הערוץ שלך ברשימה.