מקשרת שידור ב-YouTube לסטרימינג או מסירה קישור קיים בין שידור לסטרימינג. שידור יכול להיות מקושר רק לזרם וידאו אחד, אבל זרם וידאו יכול להיות מקושר לכמה שידורים.
תרחישים נפוצים לדוגמה
בקשה
בקשת HTTP
POST https://www.googleapis.com/youtube/v3/liveBroadcasts/bind
אישור
הבקשה הזו דורשת הרשאה עם לפחות אחד מההיקפים הבאים (מידע נוסף על אימות והרשאה).
| היקף |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
פרמטרים
בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים שמופיעים ברשימה הם פרמטרים של שאילתה.
| פרמטרים | ||
|---|---|---|
| פרמטרים נדרשים | ||
id |
stringהפרמטר id מציין את המזהה הייחודי של השידור שמקושר לשידור וידאו. |
|
part |
stringהפרמטר part מציין רשימה מופרדת בפסיקים של מאפיין אחד או יותר של משאב liveBroadcast שהתגובה מה-API תכלול. השמות של part שאפשר לכלול בערך הפרמטר הם id, snippet, contentDetails ו-status. |
|
| פרמטרים אופציונליים | ||
onBehalfOfContentOwner |
stringאפשר להשתמש בפרמטר הזה רק בבקשה מורשית כראוי. הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן של YouTube. הפרמטר onBehalfOfContentOwner מציין שפרטי הכניסה לאימות של הבקשה מזהים משתמש של YouTube CMS שפועל בשם בעלי התוכן שצוינו בערך הפרמטר. הפרמטר הזה מיועד לשותפי תוכן של YouTube שבבעלותם ובניהולם הרבה ערוצי YouTube שונים. הוא מאפשר לבעלי התוכן לבצע אימות פעם אחת ולקבל גישה לכל נתוני הסרטונים והערוצים שלהם, בלי לספק פרטי כניסה לאימות לכל ערוץ בנפרד. חשבון מערכת ניהול התוכן (CMS) שהמשתמש מאמת באמצעותו חייב להיות מקושר לבעלי התוכן שצוינו ב-YouTube. |
|
onBehalfOfContentOwnerChannel |
stringאפשר להשתמש בפרמטר הזה רק בבקשה מורשית. אפשר להשתמש בפרמטר הזה רק בבקשה מורשית כראוי. הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן ב-YouTube. הפרמטר onBehalfOfContentOwnerChannel מציין את מזהה הערוץ ב-YouTube שאליו מתווסף סרטון. הפרמטר הזה נדרש כשבקשה מציינת ערך לפרמטר onBehalfOfContentOwner, ואפשר להשתמש בו רק בשילוב עם הפרמטר הזה. בנוסף, צריך לאשר את הבקשה באמצעות חשבון במערכת ניהול התוכן שמקושר לבעל התוכן שמוגדר בפרמטר onBehalfOfContentOwner. בנוסף, הערוץ שצוין בערך הפרמטר onBehalfOfContentOwnerChannel חייב להיות מקושר לבעלי התוכן שצוינו בפרמטר onBehalfOfContentOwner.הפרמטר הזה מיועד לשותפי תוכן של YouTube שבבעלותם ובניהולם ערוצי YouTube רבים ושונים. היא מאפשרת לבעלי תוכן לבצע אימות חד-פעמי ולבצע פעולות בשם הערוץ שצוין בערך הפרמטר, בלי לספק פרטי כניסה לאימות לכל ערוץ בנפרד. |
|
streamId |
stringהפרמטר streamId מציין את המזהה הייחודי של שידור הווידאו שמקושר לשידור. אם הפרמטר הזה מושמט, ה-API יסיר כל קישור קיים בין השידור לבין שידור וידאו. |
|
גוף הבקשה
אל תספקו גוף בקשה כשאתם קוראים ל-method הזו.
תשובה
אם הפעולה בוצעה ללא שגיאות, ה-method מחזירה משאב liveBroadcast בגוף התגובה.
שגיאות
בטבלה הבאה מפורטות הודעות השגיאה שיכולות להתקבל מה-API בתגובה לקריאה של השיטה הזו. פרטים נוספים מופיעים במסמכי התיעוד בנושא הודעות שגיאה.
| סוג השגיאה | פרטי השגיאה | תיאור |
|---|---|---|
backendError |
internalError |
הייתה שגיאה פנימית במהלך הקישור. |
forbidden (403) |
liveBroadcastBindingNotAllowed |
הסטטוס הנוכחי של השידור החי לא מאפשר לקשר אותו לשידור. |
insufficientPermissions |
insufficientLivePermissions |
לשליחת הבקשה אין הרשאה לאחזר את השידור החי שצוין. למידע נוסף, ראו הטמעה של אימות OAuth2. |
insufficientPermissions |
liveStreamingNotEnabled |
המשתמש שאישר את הבקשה לא מורשה לשדר וידאו בשידור חי ב-YouTube. מידע נוסף זמין בכתובת https://www.youtube.com/features. |
notFound (404) |
liveBroadcastNotFound |
השידור שצוין בפרמטר id לא קיים. |
notFound (404) |
liveStreamNotFound |
הסטרים שצוין בפרמטר streamId לא קיים. |
rateLimitExceeded |
userRequestsExceedRateLimit |
המשתמש שלח יותר מדי בקשות בפרק זמן נתון. |
required (400) |
idRequired |
הפרמטר הנדרש id צריך לזהות את השידור שאליו רוצים לקשר את המודעה. |
רוצה לנסות?
משתמשים ב-APIs Explorer כדי לשלוח קריאה ל-API הזה ולראות את בקשת ה-API והתגובה.