LiveStreams: insert

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

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

בקשה

בקשת HTTP

POST 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, contentDetails ו-status.
פרמטרים אופציונליים
onBehalfOfContentOwner string
ניתן להשתמש בפרמטר הזה רק במסגרת בקשה מורשית תקינה. הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן של YouTube.

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

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

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

גוף הבקשה

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

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

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

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

    • snippet.title
    • snippet.description
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution
    • contentDetails.isReusable

תשובה

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

שגיאות

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

סוג השגיאה פרטי השגיאה תיאור
insufficientPermissions insufficientLivePermissions הבקשה לא מורשית ליצור את השידור החי שצוין.
insufficientPermissions livePermissionBlocked המשתמש שאישר את הבקשה לא יכול כרגע להפעיל וידאו בשידור חי ב-YouTube. פרטים נוספים לגבי הסיבה לכך שהמשתמש לא יכול לבצע סטרימינג של וידאו בשידור חי עשויים להיות זמינים בהגדרות הערוץ של המשתמש בכתובת https://www.youtube.com/features.
insufficientPermissions liveStreamingNotEnabled המשתמש שאישר את הבקשה אינו יכול להפעיל סטרימינג של וידאו בשידור חי ב-YouTube. המשתמשים יכולים למצוא מידע נוסף בכתובת https://www.youtube.com/features.
invalidValue (400) invalidDescription ערך המאפיין snippet.description במשאב liveStream יכול להכיל עד 10,000 תווים.
invalidValue (400) invalidFormat ערך המאפיין cdn.format במשאב liveStream לא חוקי.
invalidValue (400) invalidFrameRate הערך של המאפיין cdn.frameRate במשאב liveStream לא חוקי.
invalidValue (400) invalidIngestionType הערך של המאפיין cdn.ingestionType במשאב liveStream לא חוקי.
invalidValue (400) invalidResolution הערך של המאפיין cdn.resolution במשאב liveStream לא חוקי.
invalidValue (400) invalidTitle ערך המאפיין snippet.title במשאב liveStream חייב להיות באורך של 1 עד 128 תווים.
rateLimitExceeded userRequestsExceedRateLimit המשתמש שלח יותר מדי בקשות בפרק זמן נתון.
required (400) cdnRequired המשאב liveStream חייב להכיל את האובייקט cdn.
required (400) frameRateRequired ה-API מחזיר את השגיאה הזו אם מציינים ערך למאפיין cdn.resolution אבל לא למאפיין cdn.frameRate.
required (400) ingestionTypeRequired המשאב liveStream צריך לציין ערך עבור המאפיין cdn.ingestionType>.
required (400) resolutionRequired ה-API מחזיר את השגיאה הזו אם מציינים ערך למאפיין cdn.frameRate אבל לא למאפיין cdn.resolution.
required (400) titleRequired המשאב liveStream חייב לציין ערך עבור המאפיין snippet.title.

רוצה לנסות?

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