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