מחיקת פריט בפלייליסט.
השפעה על המכסה: העלות של קריאה לשיטה הזו היא 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 Creator Studio. |
|
גוף הבקשה
כשמפעילים את ה-method הזו, לא צריך לספק גוף בקשה.
תשובה
אם הפעולה בוצעה ללא שגיאות, ה-method מחזירה קוד סטטוס 204 No Content של HTTP.
שגיאות
בטבלה הבאה מפורטות הודעות השגיאה שה-API יכול להחזיר בתגובה לקריאה ל-method הזה. פרטים נוספים זמינים במאמר YouTube Data API - Errors.
| סוג השגיאה | פרטי השגיאה | תיאור |
|---|---|---|
forbidden (403) |
playlistItemsNotAccessible |
אין הרשאה מתאימה בבקשה למחיקת הפריט שצוין בפלייליסט. |
notFound (404) |
playlistItemNotFound |
לא נמצא הפריט בפלייליסט שזוהה באמצעות הפרמטר id של הבקשה. |
invalidValue (400) |
playlistOperationUnsupported |
ה-API לא תומך באפשרות למחוק סרטונים מהפלייליסט שצוין. לדוגמה, אי אפשר למחוק סרטון מהפלייליסט 'סרטונים שהועלו'. |
רוצה לנסות?
משתמשים ב-APIs Explorer כדי לשלוח קריאה ל-API הזה ולראות את בקשת ה-API והתגובה.