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