LiveStreams: insert

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

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

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

גוף הבקשה

מציינים משאב liveStream בגוף הבקשה. במשאב הזה:

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

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

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

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

תשובה

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

שגיאות

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

סוג השגיאה פרטי השגיאה תיאור
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 והתגובה.