LiveBroadcasts: delete

מחיקת שידור.

תרחישים נפוצים לדוגמה

בקשה

בקשת HTTP

DELETE https://www.googleapis.com/youtube/v3/liveBroadcasts

אישור

הבקשה הזו דורשת הרשאה עם לפחות אחד מההיקפים הבאים. מידע נוסף על אימות והרשאה זמין במאמר הטמעת אימות 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 שפועל בשם בעלי התוכן שצוין בערך הפרמטר. הפרמטר הזה מיועד לשותפי תוכן ב-YouTube שיש להם בעלות על ערוצי YouTube רבים ושהם מנהלים אותם. היא מאפשרת לבעלי תוכן לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוצים שלהם, בלי לספק פרטי כניסה לכל ערוץ בנפרד. חשבון ה-CMS שבו המשתמש מבצע אימות חייב להיות מקושר לבעלי התוכן שצוין ב-YouTube.
onBehalfOfContentOwnerChannel string
אפשר להשתמש בפרמטר הזה רק בבקשה מורשית.

הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן של YouTube.

הפרמטר onBehalfOfContentOwnerChannel מציין את מזהה ערוץ YouTube של הערוץ שאליו מתווסף סרטון. הפרמטר הזה נדרש כשבבקשה מצוין ערך לפרמטר onBehalfOfContentOwner, וניתן להשתמש בו רק בשילוב עם הפרמטר הזה. בנוסף, צריך לאשר את הבקשה באמצעות חשבון מערכת ניהול תוכן שמקושר לבעלי התוכן שמצוין בפרמטר onBehalfOfContentOwner. לבסוף, הערוץ שמצוין בערך הפרמטר onBehalfOfContentOwnerChannel חייב להיות מקושר לבעלי התוכן שמצוין בערך הפרמטר onBehalfOfContentOwner.

הפרמטר הזה מיועד לשותפי תוכן ב-YouTube שבבעלותם ערוצי YouTube רבים ושהם מנהלים אותם. הוא מאפשר לבעלי תוכן לבצע אימות פעם אחת ולבצע פעולות בשם הערוץ שצוין בערך הפרמטר, בלי לספק פרטי כניסה לאימות לכל ערוץ בנפרד.

גוף הבקשה

אין לספק גוף בקשה בקריאה ל-method הזה.

תשובה

אם הפעולה בוצעה ללא שגיאות, ה-method מחזיר משאב liveBroadcast בגוף התגובה.

שגיאות

בטבלה הבאה מפורטות הודעות השגיאה שיכולות להופיע בתגובה לקריאה לשיטה הזו. פרטים נוספים זמינים במאמר YouTube Live Streaming API – שגיאות.

סוג השגיאה פרטי השגיאה תיאור
forbidden (403) liveBroadcastDeletionNotAllowed הסטטוס הנוכחי של השידור החי לא מאפשר למחוק אותו.
insufficientPermissions insufficientLivePermissions אין לבקשה הזו הרשאה למחוק את השידור החי שצוין. למידע נוסף, ראו הטמעת אימות OAuth 2.0.
insufficientPermissions liveStreamingNotEnabled למשתמש שהעניק הרשאה לבקשה אין אפשרות לבצע סטרימינג של וידאו בשידור חי ב-YouTube. מידע נוסף זמין במאמר דרישות הסף לשימוש בתכונות.
notFound (404) liveBroadcastNotFound המאפיין id שצוין במשאב liveBroadcast לא זיהה שידור.

נסה בעצמך!

משתמשים ב-APIs Explorer כדי לקרוא ל-API הזה ולראות את הבקשה והתגובה של ה-API.