LiveStreams: update

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

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

בקשה

בקשת HTTP

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

אישור

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

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

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

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

גוף הבקשה

מספקים משאב liveStream בגוף הבקשה. במשאב הזה:

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

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

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

    • snippet.title
    • snippet.description

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

תשובה

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

שגיאות

בטבלה הבאה מפורטות הודעות השגיאה שיכולות להופיע בתגובה לקריאה לשיטה הזו. פרטים נוספים זמינים במאמר YouTube Live Streaming 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. מידע נוסף זמין במאמר דרישות הסף לשימוש בתכונות.
invalidValue (400) invalidDescription הערך של המאפיין snippet.description במשאב liveStream יכול להכיל עד 10,000 תווים.
invalidValue (400) invalidTitle אורך הערך של המאפיין snippet.title במשאב liveStream חייב להיות בין 1 ל-128 תווים.
notFound (404) liveStreamNotFound השידור החי שצוין לא קיים.
required (400) idRequired משאב ה-liveStream חייב לציין ערך למאפיין id.
required (400) ingestionTypeRequired משאב ה-liveStream חייב לציין ערך למאפיין cdn.ingestionType.
required (400) titleRequired משאב ה-liveStream חייב לציין ערך למאפיין snippet.title.

נסה בעצמך!

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