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