ChannelSections

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

ערוץ יכול ליצור עד 10 מדפים.

שיטות

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