מחיקת פריט מפלייליסט.
השפעה על המכסה: קריאה לשיטה הזו מחייבת עלות מכסה של 50 יחידות.
תרחישים נפוצים לדוגמה
בקשה
בקשת HTTP
DELETE https://www.googleapis.com/youtube/v3/playlistItems
אישור
הבקשה הזו דורשת הרשאה עם לפחות אחד מההיקפים הבאים. למידע נוסף על אימות והרשאות, קראו את המאמר הטמעת הרשאות OAuth 2.0.
| היקף |
|---|
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 Studio ליוצרים. |
|
גוף הבקשה
אין לספק גוף בקשה בקריאה ל-method הזה.
תשובה
אם הפעולה מצליחה, השיטה הזו מחזירה קוד סטטוס HTTP 204 No Content.
שגיאות
בטבלה הבאה מפורטות הודעות השגיאה שיכולות להופיע בתגובה לקריאה לשיטה הזו. פרטים נוספים זמינים במאמר YouTube Data API – שגיאות.
| סוג השגיאה | פרטי השגיאה | תיאור |
|---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
אין לבקשה הרשאה מתאימה למחוק את פריט הפלייליסט שצוין. |
notFound (404) |
playlistItemNotFound |
לא ניתן למצוא את פריט הפלייליסט שסומן באמצעות הפרמטר id של הבקשה. |
invalidValue (400) |
playlistOperationUnsupported |
ה-API לא תומך במחיקה של סרטונים מהפלייליסט שצוין. לדוגמה, אי אפשר למחוק סרטון מהפלייליסט של הסרטונים שהועלו. |
נסה בעצמך!
משתמשים ב-APIs Explorer כדי לקרוא ל-API הזה ולראות את הבקשה ואת התשובה של ה-API.