מחיקת וידאו בסטרימינג.
תרחישים נפוצים לדוגמה
בקשה
בקשת HTTP
DELETE https://www.googleapis.com/youtube/v3/liveStreams
אישור
הבקשה הזו מחייבת הרשאה עם לפחות אחד מההיקפים הבאים. למידע נוסף על אימות והרשאה, ראו הטמעה של אימות OAuth 2.0.
| היקף |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
פרמטרים
בטבלה הבאה מפורטים הפרמטרים שנתמכים בשאילתה הזו. כל הפרמטרים המפורטים הם פרמטרים של שאילתות.
| פרמטרים | ||
|---|---|---|
| פרמטרים נדרשים | ||
id |
stringהפרמטר id מציין את המזהה של השידור החי ב-YouTube של המשאב שמוחקים אותו. |
|
| פרמטרים אופציונליים | ||
onBehalfOfContentOwner |
stringניתן להשתמש בפרמטר הזה רק בבקשה מורשית מתאימה. הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן של YouTube. הפרמטר onBehalfOfContentOwner מציין שפרטי הכניסה להרשאה של הבקשה מזהים משתמש YouTube CMS שפועל בשם בעלי התוכן שצוין בערך הפרמטר. הפרמטר הזה מיועד לשותפי תוכן של YouTube, שבבעלותם ובניהולם של ערוצי YouTube רבים ושונים. היא מאפשרת לבעלי תוכן לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוץ שלהם, בלי שיצטרכו לספק פרטי כניסה לאימות לכל ערוץ בנפרד. חשבון מערכת ניהול התוכן שאיתו המשתמש מבצע אימות חייב להיות מקושר לבעלי התוכן שצוינו ב-YouTube. |
|
onBehalfOfContentOwnerChannel |
stringניתן להשתמש בפרמטר הזה רק בבקשה מורשית מתאימה. הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן של YouTube. הפרמטר onBehalfOfContentOwnerChannel מציין את מזהה ערוץ YouTube של הערוץ שאליו מתווסף סרטון. הפרמטר הזה נדרש כאשר בבקשה מצוין ערך לפרמטר onBehalfOfContentOwner, ואפשר להשתמש בו רק בשילוב עם הפרמטר הזה. בנוסף, הבקשה צריכה לקבל הרשאה באמצעות חשבון מערכת ניהול תוכן שמקושר לבעלי התוכן שצוין בפרמטר onBehalfOfContentOwner. לבסוף, הערוץ שערך הפרמטר onBehalfOfContentOwnerChannel מציין חייב להיות מקושר לבעלי התוכן שצוין בפרמטר onBehalfOfContentOwner.הפרמטר הזה מיועד לשותפי תוכן של YouTube, שבבעלותם ובניהולם של ערוצי YouTube רבים ושונים. הוא מאפשר לבעלי תוכן לבצע אימות פעם אחת ולבצע פעולות בשם הערוץ שצוין בערך הפרמטר, בלי שיצטרכו לספק פרטי כניסה לאימות לכל ערוץ נפרד. |
|
גוף הבקשה
אין לספק גוף בקשה כשמבצעים קריאה ל-method הזה.
תשובה
אם הפעולה בוצעה ללא שגיאות, השיטה הזו תחזיר משאב LiveStream בגוף התשובה.
שגיאות
הטבלה הבאה מזהה את הודעות השגיאה שה-API יכול להחזיר בתגובה לקריאה ל-method הזה. פרטים נוספים זמינים במאמר הודעת שגיאה.
| סוג השגיאה | פרטי השגיאה | תיאור |
|---|---|---|
forbidden (403) |
liveStreamDeletionNotAllowed |
אי אפשר למחוק את השידור החי שצוין כי הוא קשור לשידור שעדיין לא הסתיים. |
insufficientPermissions |
insufficientLivePermissions |
אין לבקשה הרשאה למחוק את השידור החי שצוין. מידע נוסף זמין במאמר הטמעת אימות OAuth2. |
insufficientPermissions |
liveStreamingNotEnabled |
המשתמש שאישר את הבקשה לא רשאי לצפות בווידאו בשידור חי ב-YouTube. מידע נוסף זמין במאמר סטטוס הפעלת תכונות. |
notFound (404) |
liveStreamNotFound |
השידור החי שצוין לא קיים. |
רוצה לנסות?
אפשר להשתמש ב-APIs Explorer כדי לשלוח קריאה ל-API הזה ולראות את בקשת ה-API ואת התגובה לבקשה.