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