מחיקת פריט בפלייליסט.
ההשפעה של המכסה: קריאה לשיטה הזו כוללת עלות מכסה של 50 יחידות.
תרחישים נפוצים לדוגמה
בקשה
בקשת HTTP
DELETE https://www.googleapis.com/youtube/v3/playlistItems
אישור
בקשה זו מחייבת הרשאה עם לפחות אחד מההיקפים הבאים (מידע נוסף על אימות והרשאה).
| היקף |
|---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
פרמטרים
בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים המפורטים הם פרמטרים של שאילתות.
| פרמטרים | ||
|---|---|---|
| הפרמטרים הנדרשים | ||
id |
stringהפרמטר id מציין את מזהה הפריט של הפלייליסט ב-YouTube שנמחק, במשאב playlistItem, המאפיין id מציין את המזהה של פריט הפלייליסט. |
|
| פרמטרים אופציונליים | ||
onBehalfOfContentOwner |
stringהערה: הפרמטר onBehalfOfContentOwner מיועד לשותפי תוכן של YouTube בלבד, ואפשר להשתמש בו רק במסגרת בקשה מורשית.הפרמטר הזה מיועד לשותפי תוכן של YouTube, שבבעלותם ומנהלים רבים ערוצי YouTube שונים. היא מאפשרת למשתמשים שהם שותפים עצמאיים של בעלי התוכן לבצע אימות פעם אחת. לאחר מכן הם יוכלו לגשת ולנהל את כל נתוני הווידאו והערוץ של בעלי התוכן, בלי שיצטרכו לספק פרטי כניסה לאימות עבור כל ערוץ בנפרד. כשהפרמטר מופיע, הערך שלו מזהה את בעל התוכן, ופרטי הכניסה של הבקשה מזהים משתמש YouTube שמורשה לפעול בשם בעלי התוכן. החשבון שבאמצעותו המשתמש מבצע אימות חייב להיות מקושר לבעלי התוכן שצוינו בהגדרות של סטודיו ליוצרים ב-YouTube. |
|
גוף הבקשה
אין לציין את גוף הבקשה בקריאה לשיטה הזו.
תשובה
אם הפעולה בוצעה בהצלחה, השיטה הזו מחזירה קוד תגובה 204 מסוג HTTP (No Content).
שגיאות
בטבלה הבאה מפורטות הודעות השגיאה שה-API עלול להחזיר בתגובה לקריאה לשיטה הזו. פרטים נוספים זמינים במסמכים בנושא הודעת שגיאה.
| סוג השגיאה | פרטי השגיאה | תיאור |
|---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
הבקשה אינה מורשית כראוי למחוק את פריט הפלייליסט שצוין. |
notFound (404) |
playlistItemNotFound |
לא ניתן למצוא את הפריט בפלייליסט שזוהה בפרמטר id של הבקשה. |
invalidValue (400) |
playlistOperationUnsupported |
ממשק ה-API לא תומך ביכולת למחוק סרטונים מהפלייליסט שצוין. לדוגמה: אין אפשרות למחוק סרטון מהפלייליסט של הסרטונים שהעליתם. |
רוצה לנסות?
משתמשים ב-APIs Explorer כדי לקרוא ל-API הזה ולראות את הבקשה והתגובה של ה-API.