LiveStreams: update

מעדכן זרם וידאו. אם לא ניתן לעדכן את הנכסים שאתם רוצים לשנות, תצטרכו ליצור שידור חדש עם ההגדרות המתאימות.

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

בקשה

בקשת HTTP

PUT https://www.googleapis.com/youtube/v3/liveStreams

אישור

בקשה זו מחייבת הרשאה עם לפחות אחד מההיקפים הבאים (מידע נוסף על אימות והרשאה).

היקף
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

פרמטרים

בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים המפורטים הם פרמטרים של שאילתות.

פרמטרים
הפרמטרים הנדרשים
part string
הפרמטר part משרת שתי מטרות בפעולה זו. היא מזהה את המאפיינים שפעולת הכתיבה תגדיר, וכן את המאפיינים שייכללו בתגובת ה-API.

מאפייני part שאפשר לכלול בערך הפרמטר הם id, snippet, cdn ו-status.

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

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

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

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

גוף הבקשה

צריך לספק משאב של סטרימינג בשידור חי בגוף הבקשה. במשאב הזה:

  • צריך לציין ערך למאפיינים הבאים:

    • id
    • snippet.title
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution

  • ניתן להגדיר ערכים למאפיינים הבאים:

    • snippet.title
    • snippet.description

    אם שולחים בקשה לעדכון, ובבקשה לא מצוין ערך לנכס שכבר יש לו ערך, הערך הקיים של הנכס יימחק.

תשובה

אם הפעולה בוצעה בהצלחה, השיטה מחזירה משאב של סטרימינג בשידור חי בגוף התגובה.

שגיאות

בטבלה הבאה מפורטות הודעות השגיאה שה-API עלול להחזיר בתגובה לקריאה לשיטה הזו. פרטים נוספים זמינים במסמכים בנושא הודעת שגיאה.

סוג השגיאה פרטי השגיאה תיאור
forbidden (403) liveStreamModificationNotAllowed לא ניתן לשנות את השידור החי שצוין במצבו הנוכחי. למידע נוסף, ראו חיי שידור.
forbidden (403) liveStreamModificationNotAllowed ה-API לא מאפשר לשנות את הערכים בשדות cdn.format, cdn.frameRate, cdn.ingestionType או cdn.resolution אחרי יצירת מקור הנתונים.
forbidden (403) liveStreamModificationNotAllowed ה-API לא מאפשר לשנות שידור לשימוש חוזר כך שלא יהיה ניתן לשימוש חוזר, או להיפך. למידע נוסף, ראו הסבר על שידורים ושידורים.
insufficientPermissions insufficientLivePermissions הבקשה לא מורשית לעדכן את השידור החי שצוין. מידע נוסף זמין במאמר הטמעה של אימות OAuth2.
insufficientPermissions liveStreamingNotEnabled המשתמש שאישר את הבקשה אינו יכול להפעיל סטרימינג של וידאו בשידור חי ב-YouTube. המשתמשים יכולים למצוא מידע נוסף בכתובת https://www.youtube.com/features.
invalidValue (400) invalidDescription ערך המאפיין snippet.description במשאב של השידור החי יכול להכיל עד 10,000 תווים.
invalidValue (400) invalidTitle ערך המאפיין snippet.title במשאב של השידור החי חייב להיות באורך של 1 עד 128 תווים.
notFound (404) liveStreamNotFound השידור החי שציינת לא קיים.
required (400) idRequired יש לציין ערך במשאב השידור החי עבור המאפיין id.
required (400) ingestionTypeRequired יש לציין ערך במשאב השידור החי עבור המאפיין cdn.ingestionType.
required (400) titleRequired יש לציין ערך במשאב השידור החי עבור המאפיין snippet.title.

רוצה לנסות?

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