דף זה תורגם על ידי Cloud Translation API.

PlaylistItems

משאב playlistItem מזהה משאב אחר, כמו סרטון, שכלול בפלייליסט. בנוסף, המשאב playlistItem מכיל פרטים על המשאב הכלול שקשורים באופן ספציפי לאופן שבו המשאב הזה משמש בפלייליסט הזה.

מערכת YouTube משתמשת גם בפלייליסט כדי לזהות את רשימת הסרטונים שהועלו בערוץ, כאשר כל playlistItem ברשימה מייצג סרטון אחד שהועלה. אפשר לאחזר את מזהה הפלייליסט של הרשימה הזו מהמשאב channel של ערוץ נתון. לאחר מכן תוכלו להשתמש בשיטה playlistItems.list ברשימה.

Methods

ה-API תומך בשיטות הבאות למשאבי playlistItems:

list: מחזירה אוסף של פריטים בפלייליסט שתואמים לפרמטר הבקשה של ה-API. אפשר לאחזר את כל הפריטים בפלייליסט מסוים או פריט אחד או יותר בפלייליסט לפי המזהים הייחודיים שלהם. כדאי לנסות עכשיו.
insert: הוספת משאב לפלייליסט. כדאי לנסות עכשיו.
עדכון: שינוי פריט בפלייליסט. לדוגמה, אפשר לעדכן את המיקום של הפריט בפלייליסט. כדאי לנסות עכשיו.
מחיקה: מחיקת פריט בפלייליסט. כדאי לנסות עכשיו.

ייצוג משאבים

המבנה הבא של JSON מציג את הפורמט של משאב playlistItems:

{
  "kind": "youtube#playlistItem",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "videoOwnerChannelTitle": string,
    "videoOwnerChannelId": string,
    "playlistId": string,
    "position": unsigned integer,
    "resourceId": {
      "kind": string,
      "videoId": string,
    }
  },
  "contentDetails": {
    "videoId": string,
    "startAt": string,
    "endAt": string,
    "note": string,
    "videoPublishedAt": datetime
  },
  "status": {
    "privacyStatus": string
  }
}

מאפיינים

בטבלה הבאה מפורטים המאפיינים שמופיעים במשאב הזה:

מאפיינים
`kind`	`string` מזהה את סוג משאב ה-API. הערך יהיה `youtube#playlistItem`.
`etag`	`etag` ה-Etag של המשאב הזה.
`id`	`string` המזהה שמשמש את YouTube לזיהוי ייחודי של פריט הפלייליסט.
`snippet`	`object` האובייקט `snippet` מכיל פרטים בסיסיים על פריט הפלייליסט, כמו השם והמיקום שלו בפלייליסט.
`snippet.publishedAt`	`datetime` התאריך והשעה שבהם הפריט נוסף לפלייליסט. הערך מצוין בפורמט ISO 8601.
`snippet.channelId`	`string` המזהה שמשמש את YouTube לזיהוי ייחודי של המשתמש שהוסיף את הפריט לפלייליסט.
`snippet.title`	`string` השם של הפריט.
`snippet.description`	`string` תיאור הפריט.
`snippet.thumbnails`	`object` מפה של תמונות ממוזערות שמשויכות לפריט בפלייליסט. לכל אובייקט במפה, המפתח הוא שם התמונה הממוזערת והערך הוא אובייקט שמכיל מידע נוסף על התמונה הממוזערת.
`snippet.thumbnails.(key)`	`object` הערכים החוקיים של המפתח הם: `default` – תמונת ברירת המחדל של התמונה הממוזערת. גודל התמונה הממוזערת שמוגדר כברירת מחדל לסרטון – או למשאב שמתייחס לסרטון, כמו פריט בפלייליסט או תוצאת חיפוש – הוא 120 פיקסלים רוחב ו-90 פיקסלים גובה. ברירת המחדל של התמונה הממוזערת של הערוץ היא 88 פיקסלים רוחב ו-88 פיקסלים גובה. `medium` – גרסה ברזולוציה גבוהה יותר של התמונה הממוזערת. עבור סרטון (או משאב שמתייחס לסרטון), התמונה הזו צריכה להיות ברוחב 320 פיקסלים ובאורך 180 פיקסלים. עבור ערוץ, התמונה הזו צריכה להיות ברוחב 240 פיקסלים ובגובה 240 פיקסלים. `high` – גרסה ברזולוציה גבוהה של התמונה הממוזערת. עבור סרטון (או משאב שמתייחס לסרטון), התמונה הזו צריכה להיות ברוחב 480 פיקסלים ובגובה 360 פיקסלים. עבור ערוץ, התמונה הזו צריכה להיות ברוחב 800 פיקסלים ובגובה 800 פיקסלים. `standard` – גרסה ברזולוציה גבוהה יותר של התמונה הממוזערת מאשר התמונה ברזולוציה `high`. התמונה הזו זמינה לחלק מהסרטונים וממקורות מידע אחרים שמפנים לסרטונים, כמו פריטים בפלייליסט או תוצאות חיפוש. התמונה הזו ברוחב 640 פיקסלים ובגובה 480 פיקסלים. `maxres` – הגרסה ברזולוציה הגבוהה ביותר של התמונה הממוזערת. גודל התמונה הזה זמין לחלק מהסרטונים וממקורות מידע אחרים שמפנים לסרטונים, כמו פריטים בפלייליסט או תוצאות חיפוש. התמונה הזו ברוחב 1,280 פיקסלים ובגובה 720 פיקסלים.
`snippet.thumbnails.(key).url`	`string` כתובת ה-URL של התמונה.
`snippet.thumbnails.(key).width`	`unsigned integer` רוחב התמונה.
`snippet.thumbnails.(key).height`	`unsigned integer` גובה התמונה.
`snippet.channelTitle`	`string` שם הערוץ שאליו שייך פריט הפלייליסט.
`snippet.videoOwnerChannelTitle`	`string` שם הערוץ שהעלה את הסרטון הזה.
`snippet.videoOwnerChannelId`	`string` מזהה הערוץ שאליו הועלה הסרטון הזה.
`snippet.playlistId`	`string` המזהה שמשמש את YouTube לזיהוי ייחודי של הפלייליסט שבו נמצא פריט הפלייליסט.
`snippet.position`	`unsigned integer` הסדר שבו הפריט מופיע בפלייליסט. הערך מתקבל מאינדקס שמתחיל בספרה אפס, כך שהפריט הראשון מקבל את המיקום `0`, הפריט השני מקבל את המיקום `1` וכן הלאה.
`snippet.resourceId`	`object` האובייקט `id` מכיל מידע שאפשר להשתמש בו כדי לזהות באופן ייחודי את המשאב שכלול בפלייליסט כפריט בפלייליסט.
`snippet.resourceId.kind`	`string` הסוג של המשאב שאליו מתייחסים.
`snippet.resourceId.videoId`	`string` אם הערך של המאפיין `snippet.resourceId.kind` הוא `youtube#video`, המאפיין הזה יופיע והערך שלו יכיל את המזהה שמערכת YouTube משתמשת בו כדי לזהות באופן ייחודי את הסרטון בפלייליסט.
`contentDetails`	`object` האובייקט `contentDetails` נכלל במשאב אם הפריט הכלול הוא סרטון ב-YouTube. האובייקט מכיל מידע נוסף על הסרטון.
`contentDetails.videoId`	`string` המזהה שמשמש את YouTube לזיהוי ייחודי של סרטון. כדי לאחזר את המשאב `video`, צריך להגדיר את פרמטר השאילתה `id` לערך הזה בבקשת ה-API.
`contentDetails.startAt`	`string` הערה: המאפיין הזה הוצא משימוש, ואם הוא מוגדר, הערך שלו לא מטופל. הזמן, שנמדד בשניות מתחילת הסרטון, שבו הסרטון אמור להתחיל לפעול. (הבעלים של הפלייליסט יכולים לציין את הזמנים שבהם הסרטון צריך להתחיל ולהפסיק לפעול כשהסרטון מופעל בהקשר של הפלייליסט). ערך ברירת המחדל הוא `0`.
`contentDetails.endAt`	`string` הערה: המאפיין הזה הוצא משימוש, ואם הוא מוגדר, הערך שלו לא מטופל. הזמן, שנמדד בשניות מתחילת הסרטון, שבו הסרטון אמור להפסיק לפעול. (הבעלים של הפלייליסט יכולים לציין את הזמנים שבהם הסרטון צריך להתחיל ולהפסיק לפעול כשהסרטון מופעל בהקשר של הפלייליסט). כברירת מחדל, ההנחה היא שה-`video.endTime` הוא סוף הסרטון.
`contentDetails.note`	`string` הערה שנוצרה על ידי משתמש לגבי הפריט הזה. האורך המקסימלי של ערך המאפיין הוא 280 תווים.
`contentDetails.videoPublishedAt`	`datetime` התאריך והשעה שבהם הסרטון פורסם ב-YouTube. הערך מצוין בפורמט ISO 8601.
`status`	`object` האובייקט `status` מכיל מידע על סטטוס הפרטיות של פריט הפלייליסט.
`status.privacyStatus`	`string` סטטוס הפרטיות של פריט הפלייליסט. הערוץ שהעלה את הסרטון שמייצג את פריט הפלייליסט יכול להגדיר את הערך הזה באמצעות השיטה `videos.insert` או `videos.update`.