הפניית API זו מסבירה כיצד לתזמן שידורים חיים וזרמי וידאו ב-YouTube באמצעות ממשק API לסטרימינג בשידור חי ב-YouTube.
סוגי המשאבים
שידורים חיים
משאב liveBroadcast
מייצג אירוע שישודר באמצעות וידאו בשידור חי ב-YouTube.
מידע נוסף על המשאב הזה זמין במאמר ייצוג משאבים ורשימת הנכסים.
Method | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
bind |
POST /liveBroadcasts/bind |
ההגדרה מחייבת את שידור YouTube לשידור או להסיר קישור קיים בין שידור לבין שידור. שידור יכול להיות מוגבל לשידור וידאו אחד בלבד, אף שייתכן ששידור וידאו יהיה משויך ליותר משידור אחד. |
delete |
DELETE /liveBroadcasts |
מחיקת שידור. |
insert |
POST /liveBroadcasts |
יצירת שידור. |
list |
GET /liveBroadcasts |
מחזירה רשימה של שידורי YouTube שתואמים לפרמטרים של בקשת ה-API. |
transition |
POST /liveBroadcasts/transition |
שינוי הסטטוס של שידור חי ב-YouTube והפעלת כל התהליכים המשויכים לסטטוס החדש. לדוגמה, כשמעבירים את הסטטוס של השידור ל-testing , המערכת של YouTube מתחילה לשדר וידאו בסטרימינג של השידור הזה. לפני שמתקשרים לשיטה הזו, צריך לוודא שהערך של המאפיין status.streamStatus של השידור שמשויך לשידור הוא active . |
update |
PUT /liveBroadcasts |
מעדכן שידור. לדוגמה, ניתן לשנות את הגדרות השידור שנקבעו באובייקט contentDetails של המשאב liveBroadcast . |
cuepoint |
POST /liveBroadcasts/cuepoint |
הוספת נקודת מגע עם שידור חי. נקודת המבט עשויה להפעיל את ההפסקה למודעה. |
LiveChatBans
משאב liveChatBan
מזהה משתמש ב-YouTube וצ'אט בשידור חי ב-YouTube שהמשתמש אסור להשתתף בו.
מידע נוסף על המשאב הזה זמין במאמר ייצוג משאבים ורשימת הנכסים.
Method | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /liveChat/bans |
הסרת חסימה שמונעת ממשתמש ספציפי לתרום לצ'אט בשידור חי ובכך מאפשרת למשתמש להצטרף מחדש לצ'אט. בקשת ה-API חייבת לקבל הרשאה מהבעלים של הערוץ או ממנחה הצ'אט בשידור חי המשויך לחסימה. |
insert |
POST /liveChat/bans |
חסימת השתתפות של משתמש ספציפי בצ'אט בשידור חי. בקשת ה-API חייבת לקבל הרשאה מהבעלים של הערוץ או ממנחה הצ'אט בשידור חי המשויך לחסימה. |
הודעות צ'אט בשידור חי
משאב liveChatMessage
מייצג הודעת צ'אט בצ'אט בשידור חי ב-YouTube. המשאב יכול להכיל פרטים על כמה סוגים של הודעות, כולל הודעת טקסט שפורסמה לאחרונה או אירוע מימון על ידי מעריצים.
תכונת הצ'אט בשידור חי מופעלת כברירת מחדל בשידורים חיים והיא זמינה במהלך האירוע בשידור חי. (לאחר סיום האירוע, הצ'אט בשידור חי כבר אינו זמין.)
מידע נוסף על המשאב הזה זמין במאמר ייצוג משאבים ורשימת הנכסים.
Method | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /liveChat/messages |
ההודעה בצ'אט תימחק. בקשת ה-API חייבת לקבל הרשאה מהבעלים של הערוץ או ממנחה הצ'אט בשידור חי המשויך לחסימה. |
insert |
POST /liveChat/messages |
הוספת הודעה בצ'אט בשידור חי. |
list |
GET /liveChat/messages |
מציג הודעות צ'אט בשידור חי בצ'אט ספציפי. |
מנהלי תגובות בצ'אט בשידור חי
משאב liveChatModerator
מייצג מנהל של צ'אט בשידור חי ב-YouTube. מנהל/ת צ'אט יכול/ה לחסום או לבטל חסימה של משתמשים בצ'אט, להסיר הודעות ולבצע פעולות ניהול אחרות בצ'אט בשידור חי.
מידע נוסף על המשאב הזה זמין במאמר ייצוג משאבים ורשימת הנכסים.
Method | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /liveChat/moderators |
הסרה של מנהל צ'אט. רק הבעלים של הערוץ של השידור החי צריך לאשר את הבקשה. |
insert |
POST /liveChat/moderators |
מוסיף מנהל חדש לצ'אט. רק הבעלים של הערוץ של השידור החי צריך לאשר את הבקשה. |
list |
GET /liveChat/moderators |
הצגת מנהלי הצ'אט בשידור חי. רק הבעלים של הערוץ של השידור החי צריך לאשר את הבקשה. |
שידורים חיים
משאב liveStream
מכיל מידע על זרם הווידאו שאתה משדר ל-YouTube. הסרטון מספק את התוכן שישודר למשתמשי YouTube. לאחר היצירה של משאב liveStream
, אפשר לשייך אותו למשאב אחד (liveBroadcast
) או יותר.
מידע נוסף על המשאב הזה זמין במאמר ייצוג משאבים ורשימת הנכסים.
Method | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
delete |
DELETE /liveStreams |
מחיקת וידאו בסטרימינג. |
insert |
POST /liveStreams |
יוצר וידאו בסטרימינג. השידור מאפשר לך לשלוח את הסרטון ל-YouTube, שם ניתן לשדר את הסרטון לקהל שלך. |
list |
GET /liveStreams |
מחזירה רשימה של זרמי וידאו שתואמים לפרמטרים של בקשת ה-API. |
update |
PUT /liveStreams |
מתבצע עדכון של שידור וידאו. אם אי אפשר לעדכן את המאפיינים שרוצים לשנות, צריך ליצור מקור נתונים חדש עם ההגדרות המתאימות. |
נותני חסות
משאב sponsor
מייצג חסות לערוץ YouTube. נותני חסות מעניקים ליוצר תמיכה כספית קבועה, כמו מינוי או דמי מינוי, ומקבל הטבות מיוחדות. לדוגמה, נותני חסות יכולים לנהל צ'אט כאשר היוצר מפעיל מצב לנותני חסות בלבד בצ'אט.
מידע נוסף על המשאב הזה זמין במאמר ייצוג משאבים ורשימת הנכסים.
Method | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
list |
GET /sponsors |
רשימת נותני חסות לערוץ. בקשת ה-API חייבת לקבל הרשאה מהבעלים של הערוץ. |
סופר צ'אט
משאב superChatEvent
מייצג הודעת Super Chat שנרכשה על ידי מעריץ במהלך שידור חי ב-YouTube. בצ'אט בשידור חי ב-YouTube, הודעות Super Chat מובלטות בשתי דרכים:
- הודעות סופר צ'אט מודגשות בצבע.
- הודעות Super Chat נשארות מוצמדות לשורת ההודעות לפרק זמן מוגדר.
הצבע של הודעת הסופר צ'אט, משך הזמן שהיא נשארת מוצמדת לשורת ההודעות ואורך ההודעה המקסימלי נקבעים לפי סכום הרכישה. במרכז העזרה של YouTube תוכלו למצוא מידע נוסף על הודעות Super Chat.
מידע נוסף על המשאב הזה זמין במאמר ייצוג משאבים ורשימת הנכסים.
Method | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
list |
GET /superChatEvents |
אני רוצה לרשום אירועי Super Chat בשידורים חיים של ערוץ ב-30 הימים האחרונים. |
סוגי משאבים שהוצאו משימוש
מימון על ידי אוהדים
משאב fanFundingEvent
מייצג אירוע 'מימון על ידי אוהדים' בערוץ YouTube. 'מימון על ידי אוהדים' מאפשר לך לתמוך בצורה כספית ביוצרים ב-YouTube. אירוע 'מימון על ידי אוהדים' מתרחש כאשר משתמש מבצע תשלום חד-פעמי לערוץ. עיין במרכז העזרה של YouTube למידע נוסף על 'מימון על ידי אוהדים'.
מידע נוסף על המשאב הזה זמין במאמר ייצוג משאבים ורשימת הנכסים.
Method | בקשת HTTP | תיאור |
---|---|---|
מזהי URI ביחס ל-https://www.googleapis.com/youtube/v3 |
||
list |
GET /fanFundingEvents |
רשימת אירועי מימון של מעריצים בערוץ. בקשת ה-API חייבת לקבל הרשאה מהבעלים של הערוץ. |